Skip to content

hakula139/oxide-code

Repository files navigation

oxide-code

CI Coverage License: MIT

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, /config, /diff, /effort, /help, /init, /model, /resume (alias /continue), /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.

Usage

export ANTHROPIC_API_KEY=sk-ant-...
ox

Documentation

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

Building from Source

Requires Rust 1.91+ (uses 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.

About

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

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages