Package Exports
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (aboocode) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
The open source AI coding agent.
Installation
npm (recommended)
npm install -g aboocode-aiThen run:
abooQuick Install (from source)
git clone https://github.com/cytsaiap-xyz/aboocode.git
cd aboocode
./install.shThis will install dependencies, build the binary, and add aboo to your PATH.
You can customize the install location:
# Change where the binary is linked (default: /usr/local/bin)
ABOOCODE_BIN_DIR=~/.local/bin ./install.shManual Install (from source)
Prerequisites
- Bun 1.3+ — install Bun
Quick Start
# Clone the repo
git clone https://github.com/cytsaiap-xyz/aboocode.git
cd aboocode
# Install dependencies
bun install
# Run in development mode (TUI)
bun devRun Against a Specific Directory
bun dev /path/to/your/project
# Run against the aboocode repo itself
bun dev .Build a Standalone Binary
# Compile for your platform
./packages/aboocode/script/build.ts --single
# Run it
./packages/aboocode/dist/aboocode-<platform>/bin/abooReplace <platform> with your platform (e.g., darwin-arm64, linux-x64).
Use aboo Command Globally
After installing from source, you can make the aboo command available system-wide:
Option 1: Bun link (recommended for development)
cd packages/aboocode
bun linkOption 2: Symlink the standalone binary
# Build first
./packages/aboocode/script/build.ts --single
# Symlink to your PATH
ln -s $(pwd)/packages/aboocode/dist/aboocode-<platform>/bin/aboo /usr/local/bin/abooOption 3: Shell alias
Add to your ~/.zshrc or ~/.bashrc:
alias aboo="bun run --cwd /path/to/aboocode dev"Then run aboo from anywhere to start Aboocode.
Available Commands
| Command | Description |
|---|---|
bun dev |
Start TUI (interactive terminal UI) |
bun dev <directory> |
Start TUI in a specific directory |
bun dev serve |
Start headless API server |
bun dev serve --port 8080 |
Start API server on custom port |
bun dev web |
Start server + open web interface |
Agents
Aboocode includes two built-in agents you can switch between with the Tab key.
- build - Default, full-access agent for development work
- plan - Read-only agent for analysis and code exploration
- Denies file edits by default
- Asks permission before running bash commands
- Ideal for exploring unfamiliar codebases or planning changes
Also included is a general subagent for complex searches and multistep tasks.
This is used internally and can be invoked using @general in messages.
Contributing
If you're interested in contributing to Aboocode, please read our contributing docs before submitting a pull request.
FAQ
How is this different from Claude Code?
It's very similar to Claude Code in terms of capability. Here are the key differences:
- 100% open source
- Not coupled to any provider. Aboocode can be used with Claude, OpenAI, Google, or even local models. As models evolve, the gaps between them will close and pricing will drop, so being provider-agnostic is important.
- Out-of-the-box LSP support
- A focus on TUI. We are going to push the limits of what's possible in the terminal.
- A client/server architecture. This, for example, can allow Aboocode to run on your computer while you drive it remotely from a mobile app, meaning that the TUI frontend is just one of the possible clients.
Based on OpenCode