See Installation for the full matrix (prebuilt tarball, Homebrew, cargo, Nix). The shortest path on macOS / Linux:
brew tap hakula139/oxide-code https://github.com/hakula139/oxide-code
brew install oxide-codeoxide-code needs an Anthropic API credential. The simplest way is to set your API key:
export ANTHROPIC_API_KEY=sk-ant-...Alternatively, if you have Claude Code installed and authenticated, oxide-code can use its OAuth credentials automatically. See Configuration for details.
oxThis opens an interactive terminal session. Type a task and press Enter:
❯ Read main.rs and explain the agent loop.
The assistant reads files, runs commands, and edits code using its built-in tools until it produces a final answer.
oxide-code has six built-in tools:
| Tool | Purpose |
|---|---|
bash |
Run shell commands |
read |
Read files with line numbers |
write |
Create or overwrite files |
edit |
Replace exact strings in files |
glob |
Find files by pattern |
grep |
Search file contents with regex |
The assistant decides which tools to use based on your request. You can guide it by being specific: "edit the function signature in src/lib.rs" is better than "fix the code".
Drop a CLAUDE.md file in your project root to give the assistant project-specific instructions:
# CLAUDE.md
- Use snake_case for all function names.
- Run `cargo test` after making changes.
- Do not modify files in the `vendor/` directory.See Instruction Files for the full discovery hierarchy.