oxide-code

A terminal-based AI coding assistant written in Rust, inspired by Claude Code.

Overview

oxide-code is a Rust reimplementation of Claude Code, an interactive CLI agent that helps developers with software engineering tasks. It communicates with LLM APIs to understand codebases, write code, run commands, and manage development workflows directly from the terminal.

Status

Early development. What works today:

• Terminal UI: streaming output, markdown rendering, syntax-highlighted code blocks, and 5 built-in themes with custom-TOML overrides
• Agent loop with extended thinking and tool-use round-trip
• File and search tools: read, write, edit, glob, grep, bash
• Turn interruption (Esc / Ctrl+C) plus mid-turn queued follow-up prompts that splice into the same turn between tool calls, with double-press Ctrl+C exit confirmation
• Slash commands with /-triggered autocomplete (name and curated-arg modes): /clear, /compact, /config, /delete, /diff, /effort, /help, /init, /model, /rename, /resume, /status, /theme
• CLAUDE.md / AGENTS.md instruction-file discovery
• Session persistence with JSONL conversation logs, listing, and resume
• Per-session file-change tracking with a Read-before-Edit gate and on-disk drift detection
• Authentication (Anthropic API key, Claude Code OAuth) and layered TOML config

See docs/roadmap.md for current focus and plans.

Installation

Four install paths are supported: prebuilt tarball, Homebrew tap, cargo install, and Nix flake. See Installation for the full matrix. The most common one-liners:

# macOS aarch64 (Apple Silicon)
curl -fsSL https://github.com/hakula139/oxide-code/releases/latest/download/oxide-code-aarch64-apple-darwin.tar.gz | tar -xz
sudo mv ox /usr/local/bin/

# Homebrew (macOS, Linux)
brew tap hakula139/oxide-code https://github.com/hakula139/oxide-code
brew install oxide-code

# From source (any Rust-supported platform)
cargo install --git https://github.com/hakula139/oxide-code --locked

# Nix
nix profile install github:hakula139/oxide-code

Usage

export ANTHROPIC_API_KEY=sk-ant-...
ox

Documentation

See the user guide for installation, configuration, slash commands, instruction files, sessions, and theming.

Development

cargo fmt --all --check                            # Check formatting
cargo build                                        # Build
cargo clippy --all-targets -- -D warnings          # Lint (pedantic, zero warnings)
cargo test                                         # Run tests
cargo llvm-cov --ignore-filename-regex 'main\.rs'  # Check test coverage
pnpm lint                                          # Lint Markdown
pnpm spellcheck                                    # Spell check

CI runs fmt, clippy, tests, coverage, Markdown lint, and spellcheck on every push and pull request. cargo build is a local quick compile check.

License

Copyright (c) 2026 Hakula. Licensed under the MIT License.