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 with markdown rendering, syntax-highlighted code blocks, and streaming display
• Agent loop with streaming and extended thinking
• File and search tools (read, write, edit, glob, grep, bash)
• System prompt with CLAUDE.md / AGENTS.md injection
• Authentication (API key and Claude Code OAuth)
• TOML config file with layered loading
• Session persistence with JSONL conversation logs, resume, and listing

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

Usage

export ANTHROPIC_API_KEY=sk-ant-...
ox

Documentation

Document	Description
Quickstart	Install, first run, basic usage
Configuration	API credentials, model selection, environment
Instruction Files	CLAUDE.md / AGENTS.md setup and discovery rules
Sessions	Session persistence, listing, and resume

Building from Source

Requires Rust 1.91+ (edition 2024).

cargo build --release

The binary will be at target/release/ox.

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

CI runs these same checks on every push and pull request via GitHub Actions.

License

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