OrbCode CLI Changelog

​

v0.3.3

​

Added

• Linked repositories (/link). A new /link slash command opens an interactive manager where you point this repo at other repos on your machine (enter a folder path — absolute, ~/path, or relative to the project). Links are persisted per-project in .orb/links.json and injected into the agent’s environment details — including each linked repo’s AGENTS.md, pulled in ahead of time — so a change here is checked for impact on, or propagated to, the linked repos. .orb/links.json is shared with the Orbital IDE extension (links written there are honored here, and vice versa), and a linked repo’s AGENTS.md is read from .orb/, .orbital/, or .orbcode/.

​

Changed

• /init now writes to .orb/AGENTS.md and targets cold-start. The generated AGENTS.md is written to the repo-level .orb/ directory and now captures project structure, architecture, business-logic mapping, and code patterns/conventions — the context an agent needs to start coding without re-exploring. The cap is now ~150 lines (up from ~60) so it can cover all four sections without being truncated.
• Repo-level agent data lives in .orb/. The folder OrbCode creates in a project for AGENTS.md (and now links.json) is .orb/ — a single, tool-neutral name shared by the IDE and the CLI. Machine settings are unchanged (~/.orbcode and <repo>/.orbcode/settings.json stay put); the legacy .orbcode/AGENTS.md location is still read for backward compatibility.

​

v0.3.2

​

Fixed

• MatterAI inference routed to the wrong backend. AxonClient was building the OpenAI baseURL by running API_GATEWAY_PATH (https://api2.matterai.so/v1/web/) through getUrlFromToken, which rehosts any api.matterai.so target onto the control-plane host resolved from the JWT — so every inference request silently hit https://api.matterai.so/v1/web/ instead of the gateway at https://api2.matterai.so/v1/web/. The gateway URL is now used directly, with the per-model baseUrl override still winning for local dev. Profile, task title, balance, and web search/fetch still go through the rehost helper (they intentionally target the control plane).

​

v0.3.1

​

Changed

• Release workflow run title now shows the version. The Release GitHub Actions workflow gained a run-name (e.g. Release v0.3.1) so manual dispatches and tag pushes are easier to tell apart in the Actions list. No functional change to the publish flow.

​

v0.3.0

​

Added

• MCP server migration from Claude Code / Claude Desktop. A new orbcode mcp migrate subcommand (with --all and --dry-run flags) and a /migrate slash command in the TUI scan well-known paths for MCP server configs and copy them into ~/.orbcode/settings.json (user scope). Sources detected:
  • ~/.claude/settings.json (Claude Code, user scope)
  • ~/.claude.json → root mcpServers (Claude Code, user scope — the most common location, written by claude mcp add -s user …)
  • ~/.claude.json → projects.<cwd>.mcpServers (Claude Code, this project)
  • claude_desktop_config.json (Claude Desktop — platform-specific path)
  When the same server name appears in both layers of ~/.claude.json, the root entry is shown and the project-layer duplicate is hidden (Claude’s own per-project override precedence). The TUI shows a combined checklist across all sources; the CLI prints a preview by default and only writes with --all. Servers whose name already exists in the destination are silently skipped and counted in the summary. Codex support (TOML) is intentionally deferred.
• Delete action in the /mcp picker. The interactive server manager gained a “Delete” action (last in the list, red) that permanently removes a server from its config file (whichever scope it lives in) and shows a y/n confirmation before doing it. Unlike Disable, Delete is irreversible — the config entry is gone, and you’ll need to re-add the server with orbcode mcp add to get it back.
• Styled OAuth callback page. The local browser page that receives the OAuth redirect now matches the matterai.so look (dark #0d1117 background, centered card, green/red circular icon, brand footer) for success, error, and not-found paths, replacing the previous plain <h1> strings.

​

v0.2.4

​

Added

• -s / --system-prompt flag to override the default system prompt. Lets power users and CI pipelines inject a custom system prompt for a single run without editing their settings.json. The flag accepts a string, so quoted inline prompts and heredoc-style values both work.

​

v0.2.3

​

Changed

• /cost renamed to /usage. The slash command and any references in the UI now use the clearer “usage” label, matching the API field returned by the backend. /cost is no longer recognized.
• orbcode mcp add -- separator. The -- flag is now consumed as the separator between the server name and the stdio command, matching Claude Code’s claude mcp add <name> -- <command>. Fixes cases where a stdio server’s own flags (e.g. -y) were mistaken for OrbCode flags.
• Local AGENTS.md ignored. A repo-local AGENTS.md placed in the current working directory is no longer auto-loaded; only ~/.orbcode/AGENTS.md (user) and the parent-directory walk (project) are read, matching the published skill/AGENTS.md docs.

​

v0.2.0

​

Added

• MCP server support. Connect external tools via the Model Context Protocol in three scopes (user, project .mcp.json, local). The interactive /mcp manager and orbcode mcp add/remove/list subcommand handle stdio, http, and sse transports. Project-scope servers require a one-time approval; OAuth 2.0 flows (RFC 9728 / 8414 / PKCE / dynamic client registration) are handled automatically, with tokens persisted under ~/.orbcode/mcp-auth/.
• Skills system. Reusable instruction sets the model loads on demand. Drop a SKILL.md under ~/.orbcode/skills/ (user) or .orbcode/skills/ (project); the catalog is injected into the system prompt and use_skill loads the full body when a task matches a skill’s when_to_use condition.
• AGENTS.md memory. Project memory is discovered by walking the cwd and parent directories for AGENTS.md and .orbcode/AGENTS.md (closer-to-cwd wins), with AGENTS.local.md layered on top for private per-machine notes. User-level ~/.orbcode/AGENTS.md is always loaded. @include directives let a memory file pull in shared snippets.
• Clipboard utility. A single clipboard helper consolidates platform-specific copy logic so the rest of the codebase stays portable.

​

v0.1.14

​

Changed

• Env var rename: ORBCODE_* → MATTERAI_*. All ORBCODE_* environment variables have been renamed to MATTERAI_* (e.g. ORBCODE_CONFIG_DIR → MATTERAI_CONFIG_DIR). Old names are no longer recognized. This unifies the CLI’s environment surface with the rest of the MatterAI tooling.

​

v0.1.8

​

Fixed

• Status bar layout cleanups. Fixed overlapping labels and inconsistent padding in the TUI status bar.

​

v0.1.5

​

Added

• Initial public release. OrbCode CLI ships with interactive TUI, headless -p mode, --yolo auto-approval, --resume for saved sessions, browser device-flow login, ~/.orbcode config, and Axon model selection.