agenttrace

(★ 121)

Local-first Rust TUI/CLI for auditing AI coding-agent sessions: cost, tokens, latency, failures, and health|本地优先 Rust TUI/CLI,审计 AI 编程 Agent 会话的成本、Token、延迟、失败与健康度

  • .codexignore
  • .gitignore
  • Cargo.lock
  • Cargo.toml
  • CHANGELOG.md
  • CODE_OF_CONDUCT.md
  • CONTRIBUTING.md
  • install.ps1
  • install.sh
  • LICENSE
  • PRIVACY.md
  • README.md
  • README.zh-CN.md
  • ROADMAP.md
  • SECURITY.md

# Installation Guide

1. Get the code
git clone https://github.com/luoyuctl/agenttrace

Downloads the entire project code from GitHub to your computer.

cd agenttrace

Moves into the project folder you just downloaded.

2. Official Install Script

Easy Recommended
Prerequisites
brew install luoyuctl/tap/agenttrace

Installs the pre-built package via Homebrew — no source build required.

npm install -g @zack78/agenttrace

Installs the package published on the npm registry globally — no need to clone the source.

curl -fsSL https://raw.githubusercontent.com/luoyuctl/agenttrace/master/install.sh | sh

Downloads and runs the official install script in one line — this handles the full setup automatically.

cargo install --git https://github.com/luoyuctl/agenttrace agenttrace

Builds and installs the package published on crates.io — no need to clone the repo yourself.

After installing, open a new terminal and run the program's version command (e.g. --version) to confirm it worked.

Pulled directly from this repo's README.

3. Node.js

Easy
Prerequisites
  • Git Needed to download the project code from GitHub.
  • Node.js Node.js must be installed to use npm. The LTS version is recommended.
npm install -g @zack78/agenttrace

Installs the package published on the npm registry globally — no need to clone the source.

After running the command, open the address shown in the terminal (usually something like http://localhost:3000) in your browser.

Pulled directly from this repo's README.

4. Rust

Medium
Prerequisites
  • Git Needed to download the project code from GitHub.
  • Rust (rustup) Installing via rustup also installs cargo.
cargo install --git https://github.com/luoyuctl/agenttrace agenttrace

Builds and installs the package published on crates.io — no need to clone the repo yourself.

cargo test

Type this command into your terminal and run it.

cargo build --release -p agenttrace

Compiles the Rust project.

If cargo build finishes without errors, it worked. The executable is created under target/.

Pulled directly from this repo's README.

// repository documentation