The all-in-one AI agent living in your terminal. Build landing, mobile apps, backends, manages files, deep research, schedule tasks and events. Self-improving, self-healing, fully autonomous. TUI, CLI and Daemon. Connect to your favorite channels.
$git clone https://github.com/adolfousier/opencrabsInstalls into the current project.
Install opencrabs by running `git clone https://github.com/adolfousier/opencrabs`, then use it for the current task and follow its documentation at https://github.com/adolfousier/opencrabs.
| 1 | [](https://www.rust-lang.org) |
| 2 | [](https://www.rust-lang.org/) |
| 3 | [](https://ratatui.rs) |
| 4 | [](https://docker.com) |
| 5 | [](https://github.com/adolfousier/opencrabs/actions/workflows/ci.yml) |
| 6 | [](https://github.com/adolfousier/opencrabs) |
| 7 | |
| 8 | # 🦀 OpenCrabs |
| 9 | |
| 10 | **The autonomous, self-improving AI agent. Single Rust binary. Every channel.** |
| 11 | |
| 12 | > Autonomous, self-improving multi-channel AI agent built in Rust. Inspired by [Open Claw](https://github.com/openclaw/openclaw). |
| 13 | |
| 14 | ``` |
| 15 | ___ ___ _ |
| 16 | / _ \ _ __ ___ _ _ / __|_ _ __ _| |__ ___ |
| 17 | | (_) | '_ \/ -_) ' \ | (__| '_/ _` | '_ \(_-< |
| 18 | \___/| .__/\___|_||_| \___|_| \__,_|_.__//__/ |
| 19 | |_| |
| 20 | |
| 21 | 🦀 The autonomous, self-improving AI agent. Single Rust binary. Every channel. |
| 22 | |
| 23 | ``` |
| 24 | |
| 25 | **Author:** [Adolfo Usier](https://github.com/adolfousier) |
| 26 | |
| 27 | ⭐ Star us on [GitHub](https://github.com/adolfousier/opencrabs) if you like what you see! |
| 28 | |
| 29 | --- |
| 30 | |
| 31 | ## 📚 Documentation |
| 32 | |
| 33 | **Official docs:** [docs.opencrabs.com](https://docs.opencrabs.com) — comprehensive guides, architecture deep-dives, and reference material. |
| 34 | |
| 35 | ### Getting Started |
| 36 | - [Installation & Quick Start](src/docs/start/GETTING_STARTED.md) |
| 37 | - [Onboarding Wizard](src/docs/start/ONBOARDING.md) |
| 38 | - [OpenCrabs Overview](src/docs/start/OPENCRABS.md) |
| 39 | |
| 40 | ### Reference |
| 41 | - [Architecture](src/docs/reference/ARCHITECTURE_2026_04_14.md) |
| 42 | - [Brain Constitution](src/docs/reference/BRAIN_CONSTITUTION.md) |
| 43 | - [Adding New Providers](src/docs/reference/ADDING_NEW_PROVIDERS.md) |
| 44 | - [Plan JSON Specification](src/docs/reference/plans/plan-json-spec.md) |
| 45 | |
| 46 | ### Brain File Templates |
| 47 | - [SOUL.md](src/docs/reference/templates/SOUL.md) — personality and voice |
| 48 | - [AGENTS.md](src/docs/reference/templates/AGENTS.md) — workspace governance and hard rules |
| 49 | - [TOOLS.md](src/docs/reference/templates/TOOLS.md) — tool usage and skills |
| 50 | - [MEMORY.md](src/docs/reference/templates/MEMORY.md) — long-term memory |
| 51 | - [CODE.md](src/docs/reference/templates/CODE.md) — coding standards |
| 52 | - [SECURITY.md](src/docs/reference/templates/SECURITY.md) — security policies |
| 53 | - [BOOT.md](src/docs/reference/templates/BOOT.md) — startup and service config |
| 54 | - [USER.md](src/docs/reference/templates/USER.md) — user profile template |
| 55 | - [HEARTBEAT.md](src/docs/reference/templates/HEARTBEAT.md) — heartbeat configuration |
| 56 | |
| 57 | ### Skills |
| 58 | - [Security Audit](src/docs/reference/templates/skills/security-audit/SKILL.md) |
| 59 | - [Cost Estimate](src/docs/reference/templates/skills/cost-estimate/SKILL.md) |
| 60 | - [Repo Audit](src/docs/reference/templates/skills/repo-audit/SKILL.md) |
| 61 | - [Multi-Agent](src/docs/reference/templates/skills/multi-agent/SKILL.md) |
| 62 | - [Browser CDP](src/docs/reference/templates/skills/browser-cdp/SKILL.md) |
| 63 | - [A2A Gateway](src/docs/reference/templates/skills/a2a-gateway/SKILL.md) |
| 64 | - [Dynamic Tools](src/docs/reference/templates/skills/dynamic-tools/SKILL.md) |
| 65 | |
| 66 | ### Cron Templates |
| 67 | - [Cron Jobs Guide](src/docs/reference/templates/cron/README.md) |
| 68 | |
| 69 | --- |
| 70 | |
| 71 | ## Why OpenCrabs? |
| 72 | |
| 73 | OpenCrabs runs as a **single binary on your terminal** — no server, no gateway, no infrastructure. It makes direct HTTPS calls to LLM providers from your machine. Nothing else leaves your computer. |
| 74 | |
| 75 | ### OpenCrabs vs Node.js Agent Frameworks |
| 76 | |
| 77 | | | **OpenCrabs** (Rust) | **Node.js Frameworks** (e.g. Open Claw) | |
| 78 | |---|---|---| |
| 79 | | **Binary size** | **34–36 MB** single binary, zero dependencies | **1 GB+** `node_modules` with hundreds of transitive packages | |
| 80 | | **Runtime** | None — runs natively | Requires Node.js runtim |