Productivity & Collaboration project-memorymulti-model-routingtask-queuesworker-handoffscheduled-automationapproval-workflowsbudget-controlsbrowser-automation

Orbital Project Agent

Keep project context local so different execution agents can take over without a fresh briefing.

FollowAgents review · FARS-2.1
Use with care
65/ 100 5-point scale 3.3 / 5
1 2 3 4 5 6
Per-dimension scores and reasoning
1Trust14 / 29 · 2.4/5

The evidence shows workspace scoping, request_access for paths outside the workspace, selectable autonomy, structured approvals, credential-request modals, OS-keychain storage, key masking, and CI secret cleanup. These support ordinary-use least privilege, confirmation, and sensitive-data handling. Tool categories and external-effect surfaces are enumerated, scheduled runs are visible, and session logs are append-only. However, authenticated browser sessions, a shared browser profile, shell and file writes, triggers, and third-party connectors create a broad authority surface without operation-by-operation confirmation rules or complete retention policies. The local-only claim conflicts with CI and test comments documenting a production telemetry endpoint and local spooling; default payloads, destination, retention, and user controls are not explained, so data-flow transparency is thin. Dependency care is demonstrated by the justified MCP upper bound, but most Python packages have broad lower bounds and no supplied lockfile, vulnerability scan, or provenance verification. Pausing, archives, and append-only logs aid contextual recovery, but there is no general rollback for file changes, commands, or remote actions. GPL notices and attribution to Orbital Contributors provide limited provenance, while the publisher and third-party asset attribution remain unclear.

2Reliability11 / 14 · 3.9/5

The README, dependency declaration, CI, and test fixtures jointly support desktop packaging, multiple providers, keychain use, telemetry controls, and cross-platform testing. Every queued task is required to end Completed or Blocked, with re-prompting and forced blocking described; test markers and installer smoke tests provide concrete skip, timeout, and failure messages, earning full credit for failure reporting. Dependency availability is reasonably addressed through Windows/macOS builds, optional extras, the MCP compatibility cap, and packaged installers, but external agent CLIs, model providers, accounts, browser components, and a relay absent from the checkout remain availability conditions. Self-consistency is reduced by Orbital versus agent-os naming, README v0.4.2 versus package version 0.12.3, and the tension between local-only positioning and documented production telemetry.

3Adaptability14 / 18 · 3.9/5

The material addresses persistent projects, queued work, one-off tasks, cross-agent handoffs, a mainland-China TokenDance path, and global provider choices, but gives little guidance for regulated enterprises, highly sensitive projects, or offline use. Capability boundaries are unusually explicit through the Is/Is Not table, beta labels, scheduler-driven autonomy limitation, platform statements, and transport distinctions. Schedules and file watchers are distinguished, and queue ordering, pausing, and blocking semantics are described, but trigger matching, debouncing, concurrency conflicts, and approval behavior for risky triggered work are not fully specified. Windows and macOS have build paths and an optional macOS integration degrades gracefully; Linux desktop support, Intel macOS coverage, and supported-version ranges for external workers are not established.

4Convention12 / 18 · 3.3/5

The workspace and global directory trees clearly assign responsibilities to sessions, memory, archives, queues, tool results, and output artifacts, earning full information-architecture credit. Quick Start covers installers, providers, account connection, and project creation, but omits source installation, upgrades, uninstallation, troubleshooting, and installer-integrity verification. Demonstrations, screenshots, examples, and feature deep dives are extensive, although there is no systematic FAQ. Beta status, incomplete full autonomy, unsigned builds, resource-dependent tests, and the external relay are disclosed, but limitations remain scattered. The full GPL-3.0 text, README badge, and SPDX headers align, fully supporting the license criterion. Releases and version notes are referenced, but package version 0.12.3, README feature version v0.4.2, and the agent-os/Orbital naming split weaken naming and version clarity; no complete changelog is supplied. Maintenance responsibility is limited to the generic Orbital Contributors label, without a named maintainer, support route, or security-update owner.

5Effectiveness10 / 13 · 3.8/5

State, decisions, lessons, queues, logs, and deliverables are stored as ordinary files with indexing, archival, explicit task outcomes, and cross-agent handoff, making the outputs highly reusable. Project-level context and replaceable workers offer plausible marginal value over isolated agent sessions, but seamless continuation and competitor comparisons are mainly first-party README claims rather than behavior corroborated by the supplied production code. The source mentions sub-five-minute setup, bring-your-own API keys, budget controls, prefix caching, and paid live turns, yet does not quantify model expense, storage growth, background resource use, browser-session risk, or maintenance overhead. Cost-benefit handling is therefore adequate rather than thorough.

6Verifiability4 / 8 · 2.5/5

Many claims point to concrete filenames, directory layouts, environment variables, versions, test markers, CI jobs, and specification identifiers. CI and fixtures cross-corroborate telemetry suppression, keychain avoidance, platform constraints, and packaged-daemon smoke tests. Key agent behavior, approval governance, memory consolidation, and competitor comparisons, however, are chiefly documented in the README without corresponding production implementation files in the supplied evidence. Comments acknowledging stale and pending screenshots improve candor, but promotional conclusions, competitor assertions, approximately 95% cache-hit claims, and exact continuation claims are not clearly separated into demonstrated facts, inference, and planned validation. Fact-inference separation is therefore thin.

Evidence confidence: Low Reviewed Sep 11, 2026 Reviewed revision 9b47dd607d24
Before you use it
  • Before using sensitive projects, verify telemetry defaults, transmitted fields, production endpoints, retention, opt-out behavior, and local-spool deletion; the local-only positioning is not fully consistent with the telemetry comments in CI and tests.
  • The shared browser profile may contain authenticated Google, GitHub, or other sessions. Use isolated accounts and confirm which cookies, tokens, and sites are visible to workers, browser tools, and delegated agents.
  • Shell execution, file writes, schedules, and file watchers can create unattended external effects. Start at the lowest autonomy level and enable continuous execution only after confirming approval rules and recovery options.
  • Installers may be unsigned or ad-hoc signed. Verify release provenance and checksums before installation, especially when using a mutable latest-download link.
  • Most Python dependencies are not locked, and installer builds are not gated on backend-test success. Pin dependencies, scan for vulnerabilities, and independently inspect the target revision's test status before deployment.
  • Do not treat the README's competitor table, cache percentage, or seamless-handoff demonstrations as independently verified evidence of performance or correctness.
Review evidence [1][2][3][4][5][6][7]
See the full review method →

What does this agent do, and when should you use it?

Orbital is a persistent management agent attached to a local project rather than a single chat session, bringing the workspace, task state, decisions, lessons, queue, budget, and approval rules under one control plane. It stores context in ordinary files such as PROJECT_STATE.md, DECISIONS.md, and LESSONS.md, then assembles that material for later tasks. The management agent plans, delegates, supervises, and records results while Claude Code, Codex, Gemini CLI, Cursor, or another CLI can serve as a replaceable worker. Its documented architecture includes a React SPA, a FastAPI and uvicorn daemon, AgentManager, SubAgentManager, TriggerManager, an Agent Loop, a tool registry, and several worker transports. The desktop application supports task queues, scheduled and file-watch triggers, browser automation, project budgets, approvals, and optional mobile supervision. Project files and state remain on the local disk; the optional cloud relay forwards approvals and events rather than files.

After the user creates a project around a local directory and selects an autonomy level, AgentManager controls its lifecycle while the Agent Loop calls models through the OpenAI or Anthropic SDK and uses shell, file, browser, and trigger tools. The management agent reads the workspace and memory files such as PROJECT_STATE.md, DECISIONS.md, and LESSONS.md under orbital/, plans the next action, and delegates through SubAgentManager. Supported transport paths named by the repository include the Codex app-server JSON-RPC interface, the Claude Code SDK, PTY, ACP, and Pipe workers. A worker receives the shared project context and creates or modifies artifacts in the workspace or orbital/output/; the manager then records the outcome for future tasks. TriggerManager can start work from cron schedules or file watches, and queued items are expected to close as either completed or blocked. The Autonomy Interceptor applies approve, deny, or bypass rules and fails closed to DENY, while project budget controls track and limit model costs. The React SPA exposes chat, files, live activity, approval cards, and settings over REST and WebSocket, with an optional Node.js cloud relay for events, approvals, push notifications, and device pairing.

  1. A developer using both Claude Code and Codex can hand an unfinished task to the other worker when one subscription runs out or encounters an account-level failure, without rebuilding the project brief.
  2. A solo maintainer of a long-running software project can preserve current state, decisions, and lessons across sessions instead of repeatedly explaining the repository.
  3. A user who queues work before leaving the computer can monitor progress remotely and intervene when a task is blocked or requires a consequential approval.
  4. A team performing repository checks, weekly growth reviews, or file-driven workflows can dispatch work through cron schedules, natural-language triggers, or file-watch triggers.
  5. A cost-conscious user can set a spending cap and reset interval per project while reviewing a model-by-model cost breakdown.
  6. A user who needs browser automation without placing website passwords in chat can keep credentials in the operating-system keychain and sign in before the agent runs.

What are this agent's strengths and limitations?

Pros
  • Context, state, decisions, and lessons live in ordinary local project files, allowing Claude Code, Codex, Gemini CLI, Cursor, and other CLI workers to operate from shared assets.
  • Governance is project-scoped: queues, budgets, approvals, audit information, and autonomy settings are not confined to one chat session.
  • The architecture documents several worker transports, including Codex app-server JSON-RPC, the Claude Code SDK, PTY, ACP, and Pipe, alongside multi-provider routing through OpenAI and Anthropic SDKs.
  • Cron and file-watch triggers, natural-language trigger creation, browser automation, and explicit completed-or-blocked queue closure support unattended workflows.
  • The local-first boundary keeps project files and state on the user's disk; credentials use the system keychain, and approval interception fails closed.
Limitations
  • The project describes itself as early-stage. Recovery of in-progress sessions after daemon restart, webhook and pipeline triggers, and per-project network isolation remain roadmap items.
  • The packaged macOS edition requires macOS 13+ on Apple Silicon and does not support Intel Macs; Linux bubblewrap sandboxing is still planned.
  • The Windows installer is not yet code-signed, so users may need to bypass a SmartScreen warning manually.
  • Model execution requires the user's own provider key or Token, making availability and operating cost dependent on external services; account connectors and browsing also require network access and sometimes advance sign-in.
  • Source deployment involves both a Python 3.11+ backend and Node.js 18+ frontend, with separate uvicorn and Vite processes.
  • Orbital sends one anonymous aggregate telemetry payload per day by default. It excludes prompts, files, paths, model outputs, and project identifiers and can be disabled, but privacy-sensitive adopters must still review that setting.

How do you install or deploy this agent?

For the desktop build, download Orbital-Setup-*.exe for Windows or Orbital-*-macOS.dmg from GitHub Releases. On macOS, open the DMG and drag Orbital into Applications. The macOS build requires macOS 13 Ventura or later and Apple Silicon; the Windows installer is currently unsigned and may trigger SmartScreen.

To run from source:

git clone https://github.com/zqiren/Orbital.git && cd Orbital
pip install -e ".[desktop]"

cd web && npm install && cd ..

python -m uvicorn agent_os.api.app:create_app --factory --port 8000

In a second terminal, run:

cd web
npx vite --host 127.0.0.1 --port 5173

Open http://localhost:5173. A source installation requires Python 3.11+ and Node.js 18+. During first-run setup, configure an API key for a supported LLM provider; users in mainland China may alternatively use the documented TokenDance sign-in flow to obtain a Token.

How do you use this agent?

  1. Start Orbital and use the setup wizard to select an LLM provider and enter its API key. Google Calendar, Drive, and browser-site account connections are optional and can be added later.
  2. Create a project, give it a name, choose a local workspace directory, and select an autonomy level.
  3. Enter the first task in chat. The management agent reads the project files, plans the work, and either handles it or delegates it to an available worker.
  4. Add later tasks to the queue. Completed outputs and notes become context for the next queued item.
  5. To change executors, address another worker with an @mention in the same conversation. The documented example switches from an exhausted Claude Code account with an instruction equivalent to “@codex, continue.”
  6. Create scheduled or file-watch triggers for recurring work, then supervise execution through live activity, approval cards, the workbench, calendar, and budget settings.

How does this agent compare with similar options?

Unlike Claude Code or Codex as session-centered, vendor-specific workers, Orbital positions the project as the durable unit and can delegate across Claude Code, Codex, Gemini CLI, Cursor, and arbitrary CLI workers. Its July 2026 table says Claude Code and Codex are limited to their respective workers, whereas Orbital requires queued tasks to close as completed or blocked and assigns budgets, approvals, and audit responsibility to the project. The repository contrasts this with Hermes, which it describes as limited to Hermes workers, and with OpenClaw, whose external-agent support it characterizes as partial through ACP. These are the repository author's product comparisons, not independent benchmark results.

FAQ

Does Orbital require OpenAI or Anthropic?
No single provider is mandatory. The setup flow names more than ten providers, including DeepSeek, Moonshot, Zhipu, MiniMax, Anthropic, and OpenAI, and the roadmap lists multi-LLM routing with failover as complete. A valid key or Token for the chosen provider is still required.
Are project files uploaded to the cloud?
Project files and state remain on the local disk. The optional cloud relay forwards approvals and events rather than files. Orbital also sends a disableable daily anonymous aggregate telemetry payload.
What happens when a worker fails midway?
The management agent can inspect the error, recognize an account-level problem it cannot resolve, rebuild the relevant brief from project files, and delegate the task to another worker. Queue items are recorded as completed or blocked instead of silently disappearing.
Will Orbital execute every action without asking?
The project's autonomy preset controls execution and cascades to sub-agents. Consequential actions can require approval, the interceptor defaults to DENY on failure, and decisions reserved for the user—such as spending or sending a message from the user's account—can be surfaced in the workbench.
Which desktop platforms are supported?
Windows and macOS installers are documented. The macOS build requires Ventura 13 or later and Apple Silicon, with Intel Macs explicitly unsupported. Linux bubblewrap sandboxing is planned, but no Linux desktop release is documented.

Compare agents like this one

The same FARS review applied across the shortlist this agent qualifies for.

Related agents