Skip to content

aeroxy/archa

Repository files navigation

Archa Logo

Archa: Agentic CLI Session Chronicle

Browse, read, and export your Agent sessions through a high-fidelity academic interface.


Archa is a local-first explorer for your Agent conversation history. It transforms fragmented JSONL session data into a readable, searchable, and exportable chronicle.

Features

  • Multi-source: Reads both Claude Code (~/.claude/projects) and OpenCode (~/.local/share/opencode/*.db) sessions.
  • Three-Column Layout: Backend switcher, Project Explorer, and high-precision Reader.
  • Project Discovery: Extracts true project paths from session metadata for accurate display names.
  • Academic Typography: Designed for focus with Inter (UI), Newsreader (Serif Body), and Space Grotesk (Code).
  • Markdown Export: Save any session as a clean Markdown file for your own records.
  • Single Binary: The React frontend is embedded directly into the Rust backend.
  • Dynamic Port Selection: Automatically finds an available port to avoid conflicts.

Installation

Via Homebrew (macOS)

brew tap aeroxy/archa https://github.com/aeroxy/archa.git
brew install aeroxy/archa/archa

From Source

# Requires Rust and Bun (or NPM)
git clone https://github.com/aeroxy/archa.git
cd archa
make build

# The binary will be at ./target/release/archa

Usage

Simply run the binary:

archa

Options

archa --help

# Usage: archa [OPTIONS]
#
# Options:
#   -p, --port <PORT>                 Port to listen on [default: 3000]
#   -P, --projects-path <PROJECTS_PATH>  Custom path to Claude projects
#   -h, --help                        Print help
#   -V, --version                     Print version

Development

# Start both backend and frontend dev server with HMR
make dev

License

MIT

About

Local-first Agent session reader and explorer with an embedded web UI

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors