Rebon-Code
Health Warn
- License — License: Apache-2.0
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Low visibility — Only 5 GitHub stars
Code Fail
- rm -rf — Recursive force deletion command in .github/workflows/release.yml
- exec() — Shell command execution in assets/web-ui/dist/assets/markdown.js
Permissions Pass
- Permissions — No dangerous permissions requested
No AI report is available for this listing yet.
Another agent coding tool with auto mode, auto routing and more
|
|
rebonAn agent CLI for coding and more — a terminal harness that drives an LLM through a real agent loop with tools, sessions, permissions, and a full TUI.
|
What is in this repository
The rebon command-line agent and everything it needs to build: the crates, the
plugins, the packaging chain and the release workflow.
Rebon's other surfaces ship on their own schedules and are not in this tree.
Comments here name them because the code they share was shaped by them:
| Surface | Where it lives |
|---|---|
| Desktop app | https://reboncode.ai |
| Mobile client | https://reboncode.ai |
Web UI (rebon serve) |
the @rebon/rebon-web npm package |
assets/ holds the artefacts the CLI reads from those surfaces — the Windows
icon, the generated i18n catalogues, and a committed build of the web UI thatbuild.rs embeds so cargo build never needs Node.
About the tags in this repository
This repository was previously where Rebon's releases were published, so its
refs carry a large number of app-v* tags from the desktop app. They are kept
deliberately: they are where those releases live, and deleting them would
break the links pointing at them.
They have nothing to do with the CLI. The CLI's own releases are the v*
tags, and those are what the release workflow builds and publishes from.
Install
npm install -g @rebon/cli
Upgrade later:
npm install -g @rebon/cli@latest
@rebon/cli is a thin launcher that pulls the matching native binary as
an optional dependency. Supported platforms: win32-x64, darwin-x64,darwin-arm64, linux-x64, linux-arm64.
If install fails with "missing optional platform package", you likely passed
--omit=optionalor--no-optional. Reinstall without that flag.
Quick start
# Local TUI in the current directory
rebon
# Resume a previous session
rebon --resume k7m2q-4xr9t-hb3wz-p8ncv
# Override the active provider / model
rebon --provider openrouter --model gpt-5.5
# Run as an ACP JSON-RPC server on stdio (for editor / IDE integrations)
rebon --acp
# Work on a project that lives on another machine
rebon remote add prod [email protected] --path /srv/app
rebon --remote prod
The first run drops you into onboarding: pick a provider, sign in (OAuth +
PKCE for Claude / OpenAI, or paste an API key), and you're in.
CLI flags
| Flag | Purpose |
|---|---|
--acp |
Run as an ACP JSON-RPC server on stdio. |
--provider <name> |
Override activeCustomProvider from ~/.rebon/config.json. |
--model <id> |
Override the resolved provider's default model. |
--resume <id> |
Load an on-disk transcript and replay it into the TUI. |
--remote <name> |
Run the session on a configured remote host over ssh. |
--remote-path <p> |
Project directory on that remote. Requires --remote. |
Config & data
~/.rebon/config.json— providers, models, credentials, defaults.~/.rebon/sessions/— saved transcripts.~/.rebon/skills/,~/.rebon/agents/,~/.rebon/memory/— user assets.$REBON_LOG_DIR/rebon.log— TUI log file (defaults to%TEMP%/rebon/logs/rebon.logon Windows,$TMPDIR/rebon/logs/rebon.log
elsewhere).--acpmode logs to stderr instead.
Project-level overrides live under .rebon/ and .claude/ in your working
directory.
What you get
- Local TUI — prompt input with history, paste, image paste,
@-mention
and slash-command pickers, queued submissions, mode cycling; streaming
transcript with markdown, tool grouping, thinking blocks, plan approval,
permission modal; full dialog stack for onboarding, settings, resume,
rewind, quick-open, history search, global search, tasks, background
tasks, teams, agents. - Agentic tool loop — Bash / PowerShell, Read / Write / Edit, Glob /
Grep, Sleep, TaskCreate / TaskUpdate / TaskList / TaskGet / TaskStop,
Agent, SkillTool, AskUserQuestion, SendMessage, EnterPlanMode /
ExitPlanMode, ToolSearch, Team{Create,Delete,Files,Mailbox,Manager},
Worktree, plus MCP tools (stdio, Streamable HTTP, legacy SSE). - Providers — Anthropic, OpenAI, and OpenAI-Responses, with streaming,
compact / context-prune passes, and automatic session titles. - Permissions, hooks, sandbox — fine-grained allow / deny for shell,
filesystem, web-fetch, and skill invocations; user-defined hooks; sandbox
config with violation reporting. - Skills, agents, memory — bundled and user skills; spawnable
worker agents and a coordinator for background tasks; a persistent memory
layer with recall and surfacing. - Remote hosts — run a session against a project on another
machine over ssh. A server build is installed on the far end and the
agent executes there — shell, filesystem, git — while this machine
keeps the UI and the transcript.rebon remote add, thenrebon --remote <name>. - ACP server — drive Rebon from an editor over stdio JSON-RPC:
initialize,session/new,session/load,session/list,session/prompt,session/cancel, reverse-RPC permission prompts,
streamed tool output.
Common tasks
# Start a fresh session in the current repo
rebon
# Resume the last session you worked on (use Tab in the TUI to browse)
rebon --resume <session-id>
# Plug Rebon into an editor over ACP (the editor manages stdio for you)
rebon --acp
# Override provider/model without editing config
rebon --provider anthropic --model claude-opus-4-7
Inside the TUI:
?— keyboard help/— slash-command picker@— file / symbol mentionTab— switch panel / listEsc— cancel current step or dismiss a dialog
Updating
rebon ships with a built-in updater that checks for new releases on launch.
You can also just rerun:
npm install -g @rebon/cli@latest
Privacy
Rebon has no telemetry — no analytics, no crash reporting, no usage events,
no anonymous install ID. The only request it makes on its own is the update
check above: a plain GET for @rebon/cli's public npm metadata, carrying
no identifiers and not even your current version. Everything else on the
wire is a request you made — a model turn, a WebFetch, an MCP call.
PRIVACY.md lists every outbound request the binary can make,
with the file each one lives in, plus the commands to verify it yourself.
Troubleshooting
- "missing optional platform package" — reinstall without
--omit=optional/--no-optional/--ignore-optional. - "unsupported platform" — your
process.platform/process.archis not
one of the five supported targets. - TUI looks scrambled — make sure your terminal supports truecolor and
Unicode width tables (modern Windows Terminal, iTerm2, Alacritty, WezTerm,
Kitty all work). The legacycmd.exeandconhostare not supported. - Logs — check
$REBON_LOG_DIR/rebon.log(TUI) or stderr (--acp).
Friends
Linux.Do — A new ideal community
License
Licensed under the Apache License, Version 2.0.
Redistributions must carry the licence and the attribution notice in
NOTICE, and modified files must say that they were changed.
Third-party components and their licenses are listed in
THIRD_PARTY_NOTICES.txt.
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found