- Автор
- imrj05
- Размер
- 316.4 MB
- Звёзды
- 159
- Обновлён
- КоммитNov 15Релизv0.2.19Nov 14
- Возраст
- 2 мес
- Коммиты · 90 дней
README проекта с github.com/imrj05/orbit. Одним файлом markdown: README.md.

Orbit Pi is a native desktop workbench for the pi coding agent — a chat-style GUI rendered entirely in Rust on GPUI, the GPU-accelerated UI framework Zed is built on. It speaks the pi CLI's RPC protocol directly over stdio: no browser, no webview, no Node.
Sessions you create in Orbit and in the terminal are the same sessions (~/.pi/agent/sessions/), managed by pi's own session manager.
A live session — streaming transcript, tool rows, and the composer:

Usage — requests, tokens, cost, and cache, read from your own sessions; point at any summary sparkline to read that day across the whole row:

| New task | Review |
|---|---|
![]() |
![]() |
| Git | Providers |
![]() |
![]() |
| Plugins | Skills |
![]() |
![]() |
| Models | Appearance |
![]() |
![]() |
| General | Agent |
![]() |
![]() |
Chat and transcript
flowchart/graph fence paints as a real diagram
(GPUI paths and text, no webview), subgraph groups included, with the copyable source one
click away; every other Mermaid diagram type keeps the honest source block instead of a fake
preview@path mention the agent opens with its tools. The sent message shows those files as the same chips under the bubble (the path stays selectable), so a reloaded session looks like the live send. Pasting an image file copied in Finder or Windows Explorer attaches its contents rather than its file icon. On Linux, file URI lists exposed as clipboard text are supported; file-only clipboard offers are not yet supported. The + menu picks several images or files at once. All three kinds share one eight-item budgetSessions
↑n/↓n against upstream), and provider/model marks. Tinted project marks, semantic status badges, one title weight, and a neutral selection fill with a distinct focus outline make the list easier to scan; flat mode names each row's workspace and branch, and a grouped row adds that line only when its folder differs from the header'sSafeguards
tool_call and confirms mutating calls the mode does not auto-approveInherit · Allow · Ask · Deny, the resolved value shown beside it, and pattern rules beneath (rm * → Deny). Switch the scope between every session, main sessions only, or one subagent. Full access still means full access: it is answered before the rules, so nothing asks and nothing is refused there. "bash may run, but rm asks" needs no mode change; a subagent has no approval window, so its rules are what let a worker use a command at allallow rulepi process with its own context window and get back a short report plus its cost. Children inherit the session's access and workflow modes; a delegation the session mode cannot finish is refused before it spends anythingReview and Git
Settings → Git Accounts inspects local Git author settings, generic and host-scoped credential helpers, SSH agent fingerprints and conventional public-key file presence, remote hosts and the GitHub CLI version without managing credentials. Git author identity is not authentication; a helper or loaded SSH key does not prove that a valid credential exists or that a remote accepts it. Remote access is not tested. The page does not run gh auth status, since it can contact hosts and refresh credentials, so GitHub CLI authentication remains unknown. An optional Check for updates action anonymously checks the latest stable GitHub CLI release and shows manual update commands; ordinary status refresh stays offline and Orbit does not run the update. Public-key file detection checks conventional names without opening their contents on Unix; it is unavailable on Windows. Environment-variable indicators reflect only Orbit’s process environment, which may differ from your terminal. Resolve authentication problems manually with your existing tools; credentials may be expired or lack permissions.
n / p between files, [ / ] between hunks)gh: browse and filter, file issues and PRs, comment, apply labels, close/reopen, review, merge, and check out a PR's branch — with repository templates and an AI Generate action that drafts a title and body from the branch, its commits, optional notes, and the repo's own templaterepo/.wt/113 → feature/issue-113), opens them as the active workspace so the Explorer, terminal, Git page, Review, and agent all run there, and supports rename / move / lock / remove / prune / repairLocal, linked worktrees, recent folders, a new or existing worktree, a remote branch (as a local branch that tracks it), a clone, or another folder. The new-task picker offers the same choices; there, remote branches are selected in the create dialog. Outside a repository, the status bar uses a folder chip; the new-task picker still offers cloningORBIT_ROOT_PATH and ORBIT_WORKTREE_PATHExplorer and Files
M/A/D/R/U git badges, and keyboard navigationTerminal
alacritty_terminal for PTY and VT/ANSI emulation and rendered natively by GPUI: scrollback, click-drag selection (⌘C/⌘V), bracketed paste, a blinking cursor, a per-theme ANSI palette, and restart; the shell follows the active workspaceWorkbench
${NAME} secret store, live status and tool lists from pi mcp list --json, and applying changes by respawning pi with the session preservedmodels.json), with API-key or OAuth sign-in and usage metersgh account): through the gh CLI when it is signed in, or as a prefilled GitHub new-issue page otherwisegh issue create --attach when permitted; otherwise, if the CLI cannot upload them before creating an issue, the web form and saved screenshot folder open so you can drag them inpi sessions on a schedule you choose. Nothing is uploadedNative
theme/tokens.rs for spacing, type, controls, elevation and motion. Dynamic spacing follows UI font size and Spacing Density; other tokens use their own resolvers and preferences. Settings, usage, the sidebar, transcript chrome, pickers, modals, the Explorer, Git and terminal use the shared vocabulary.pi, node, and git that reports anything missing with its install command.dmg (signed + notarized, universal) and .tar.gz, Windows .exe / .zip, Linux .deb / .tar.gz, with signed in-app updates on every platformExtract the release tarball into its own orbit-pi or orbit-pi-* directory and run bin/orbit-pi there. Do not merge it into a shared prefix such as ~/.local or /usr. The in-app installer only replaces a dedicated directory with the known release layout and no extra files or symlinks; on unsupported layouts the updater is normally disabled, so update manually or through your package manager. ORBIT_FORCE_UPDATER=1 enables checking without installation for development. Existing tarball layouts remain supported. Keep personal files outside the install directory. Linux updates retain the old directory as a hidden .orbit-pi*.rollback-* sibling; after checking the new version, you may remove that backup yourself. Release packaging changes must update the updater's layout validation before adding files.
┌───────────────────────────────────────────┐
│ Orbit (Rust) — GPUI, Metal-rendered UI │
│ crates/orbit-pi │
│ window, transcript, markdown, workbench │
└──────────────┬────────────────────────────┘
│ newline-delimited JSON RPC over stdio
┌──────────────▼────────────────────────────┐
│ pi CLI (child process, per open session) │
│ pi --mode rpc — sessions, models, tools │
└──────────────┬────────────────────────────┘
│
┌──────────────▼────────────────────────────┐
│ ~/.pi/agent/ — sessions, config, usage │
│ (same data the pi CLI uses) │
└───────────────────────────────────────────┘
Orbit spawns the pi CLI as a child process per open session and speaks its RPC protocol: JSON requests on stdin, JSON-line events on stdout (text/thinking deltas, tool calls, question dialogs, settle signals). Everything user-facing is painted by GPUI on Metal — no DOM, no CSS, no browser engine. The agent runtime stays pi itself, so the model catalog, thinking levels, and persistence remain pi's own.
crates/orbit-pi/ The GPUI app — window, transcript, markdown, workbench
crates/orbit-rpc/ pi CLI RPC client (process lifecycle + JSONL protocol)
contrib/ Bundled pi extensions (access guard, auth/quota bridges)
scripts/make-dmg.sh Build a signed .app + DMG (arm64 / universal)
assets/icons/ App icon (logo-icon.png source, icon.icns, icon.png)
marketing/ Next.js landing page
PRODUCT.md Product definition, capabilities, constraints
INTENT.md Architecture decisions + phase plan
AGENTS.md Conventions for agents and humans working on this repo
PRIVACY.md What Orbit does and does not send
Orbit is a workbench, not just a chat window. The confirmed direction lives in PRODUCT.md, architecture decisions in INTENT.md, and shipped work in CHANGELOG.md. Every unchecked item below is open for a pull request — read CONTRIBUTING.md and claim the linked issue before starting.
| Feature | Area | Description | Status | Tracking |
|---|---|---|---|---|
| Workflow modes | Composer | Start a session scoped to Plan Mode, Build Mode, or Ask Mode instead of one undifferentiated chat. | Shipped | — |
| Follow-up on settle | Transcript | Show a queued follow-up inline once a run ends, not only in the compose queue. | Planned | — |
| Suggested follow-ups | Transcript | Propose 2–3 context-grounded next prompts as composer inserts after a run settles. | Proposed | #10 |
| GitHub client | Workbench | Browse and manage remote commits, graph, issues, and pull requests in-app. | In progress — Issues and Pull requests ship with comments, reviews, merges, and branch checkouts; a remote-commits view remains open (#8 closed for the issues/PRs half) | — |
| Pi extension support | Workbench | First-class list / install / enable / configure / debug of pi extensions, including community ones. | In progress — Plugins installs, updates, and removes packages; a dedicated extensions surface with enable/configure/debug is still open | #7 |
| Global default model | Models | Pin pi's global default model and thinking effort from within Orbit. | Shipped — Settings → Agent sets the model and thinking level every new session starts on (Orbit's own store; pi's global settings are untouched) | #9 |
| Voice dictation | Composer | Dictate prompts into the composer. | Planned | — |
| Diff review and terminal | Workbench | Inline diff review and an integrated terminal. | Shipped — Review pane with per-turn checkpoints and view controls, plus a login-shell terminal (⌘J) | — |
| Terminal tabs | Terminal | Run several shells in the bottom panel without losing the ones in the background. | Shipped — ⌘T / ⌘W / ⌘⇧] / ⌘⇧[, each tab holding its own PTY | — |
| Git worktrees | Workbench | List, create, open, move, lock, repair, and prune worktrees, and work in one as the active workspace. | Shipped — Worktrees page, Work in on the status bar in a repository and on the new-task page, plus an optional per-repository setup script. Clone from URL is implemented, with the Windows job-object cancellation path covered on the Windows CI leg; manual GUI verification remains. | — |
| Session retention | Workbench | Keep pi's session store from growing without bound. | Shipped — Settings → Privacy archives or deletes idle sessions on a schedule, alongside Orbit and pi scratch-file cleanup | — |
| Parallel sessions | Sessions | Run multiple agents / sessions side by side. | Planned | — |
| Explorer gaps | Explorer | Quick-open, sticky scroll, and directory folding in the file tree. | Planned — expand/collapse, filter, hidden toggle, and git badges ship today | — |
| Markdown export | Transcript | Save the visible transcript or an individual response as Markdown. | In progress — response footer and transcript palette actions are implemented; GUI verification remains | — |
| Conversation fork/rewind | Sessions | Branch and rewind a conversation. | In progress — user-message rewind, response-footer fork picker, and a palette action create a new session and leave the old one in the sidebar. The response footer opens a chooser because pi forks before user messages; GUI verification remains | — |
| Scroll-perf measurement | Performance | On-device measurement of transcript scroll performance. | Planned | — |
| Design-system unification | Design | One token layer (colour, geometry, state, motion) across every surface, with the interaction-state and motion contracts enforced by scripts. | Done — see DESIGN.md and docs/design-system-audit.md | — |
Orbit leans on a lot of other people's work. The full license texts ship in NOTICE and beside each asset in the repo.
The agent
Framework and libraries
theme/tokens.rs come from.crates/orbit-pi follow its approach.Icons
Fonts
Every family in crates/orbit-pi/assets/fonts/bundled/ ships under the SIL Open
Font License 1.1: Anonymous Pro, Atkinson Hyperlegible, Cascadia Code, Commit
Mono, DM Mono, DM Sans, Fira Code, Fixel Text, Geist, Geist Mono, IBM Plex Mono,
Inconsolata, Inter, Iosevka, JetBrains Mono, Manrope, Martian Mono, Noto Sans,
Noto Sans Mono, Onest, Roboto, Roboto Mono, Source Code Pro, Source Sans 3, and Space
Mono. IBM Plex Sans and Lilex come from Zed's font set, also OFL 1.1.
Marketing site
Built with Next.js, React,
Tailwind CSS, Base UI,
HugeIcons for React, and
shadcn/ui patterns. Sora and Geist Mono are served
through next/font. The Apple mark in the download buttons follows
gilbarbara/logos (CC0), and the Tux mark
comes from tandpfun/skill-icons (MIT).
People
Something missing from this list is a bug. Open an issue and it gets fixed.
Setup, checks, and commit conventions live in CONTRIBUTING.md. Orbit is licensed under Apache-2.0; report vulnerabilities per SECURITY.md. Data handling is documented in PRIVACY.md.