Orbioom

Product Documentation

Orbioom Code

A local-first, cross-platform coding CLI (`orb`) built in Go that routes tasks through planning, execution, and verification using controlled local tools.

Back to OrbioomStart with CLI

What It Is

A coding operator for real local workflows.

Orbioom Code is an agentic CLI that helps engineers execute development tasks inside existing repositories using explicit tool calls.

It is implemented as a single binary and focuses on local execution: your files, your shell, your Git context, and your approval boundaries.

What It Does

Core capabilities in v1.

The current implementation combines model reasoning with a strict local tool registry and approval flow designed for engineering tasks.

01

Local-first coding agent

Orbioom Code runs on your machine as a single binary and executes tasks directly in your local project context.

02

Provider-based model runtime

Use OpenAI or Anthropic credentials, select a model, and run the same workflow in chat mode or one-shot mode.

03

Built-in engineering tools

The agent can read and write files, run shell commands, manage interactive PTY sessions, and perform Git operations.

04

Stateful execution loop

Tasks progress through planning, execution, verification, and completion with explicit status transitions and validation.

Command Surface

CLI commands and intent.

The `orb` command set supports setup, interactive development sessions, and one-shot execution for automation-style tasks.

orb login
Configure provider, model, and API key.
orb whoami
Show active provider, model, and key presence.
orb init
Create local .orbioom project configuration.
orb config get/set
Read or update provider/model/debug settings.
orb chat
Start the interactive REPL agent workflow.
orb run "task"
Execute one task non-interactively.
orb doctor
Validate environment dependencies and runtime basics.
orb tools
List all registered local tools.

Tooling

Local tools exposed to the agent.

File tools

list_dir, read_file, search_in_files, write_file, apply_patch, delete_file

Shell and app tools

run_command, open_url, open_application, open_permission_settings, download_file, resolve_application

Interactive tools

run_interactive_command, interactive_send, interactive_read, interactive_stop

Git tools

git_status, git_diff, git_commit, git_checkout

Agent Lifecycle

Explicit state machine.

Every task advances through fixed states with approval and completion checks before final output is returned.

  1. 01IDLE
  2. 02AWAITING_PERMISSION
  3. 03PLANNING
  4. 04EXECUTING
  5. 05INTERACTIVE_RUNNING
  6. 06VERIFYING
  7. 07COMPLETED / FAILED

Quickstart

Build and run in minutes.

The workflow starts with login, then either interactive `chat` or one-shot `run`.

Build + Chat
go build -o dist/orb .
./dist/orb login
./dist/orb chat
One-shot Run
./dist/orb run "download https://example.com/file.zip to ./downloads/file.zip"

# interactive PTY session:
/exit-session