Two developer surfaces on top of the agent runtime: a local web viewer for inspecting agent runs and traces, and a coding-agent CLI. Viewer: - aisuite/tracing: a local ViewerServer that serves a runs/trace UI, plus HttpTraceSink, TraceStoreSink, and InMemoryTraceStore - viewer-ui: React/Vite single-page app for browsing runs, with the prebuilt bundle shipped under aisuite/tracing/static/viewer CLI: - cli/py/aisuite-code-cli: the aisuite-code coding-agent CLI (app, agent loop, approval flow, config, rendering) as a standalone package - scripts/aisuite-code launcher and examples/cli usage - tests for the viewer server, trace sinks, and the CLI Co-authored-by: Rohit <rohit.prasad15@gmail.com>
1.4 KiB
aisuite-code
aisuite-code is a local coding agent CLI built on the aisuite agent framework.
It is intentionally small for now: a conversation loop, cwd-scoped file tools,
approval-gated shell/write tools, and trace output that can be inspected in the
aisuite runs viewer.
Install and run from this package directory:
cd cli/py/aisuite-code-cli
python3 -m poetry install
python3 -m poetry run aisuite-code --cwd /path/to/project
From the repository root, use the convenience shim:
./scripts/aisuite-code --cwd /path/to/project
The CLI package depends on the OpenAI provider by default because the default
model is openai:gpt-4o-mini. Set OPENAI_API_KEY in your shell before running
the CLI, or source the repository .env file first.
Useful commands inside the CLI:
/help
/viewer
/viewer start
/status
/clear
/exit
By default the CLI can read and write within --cwd, but write operations still
require approval. Shell commands are limited to common coding commands unless
--allow-shell-all is supplied.
The main agent also has a read-only reviewer subagent available as
review_changes(input: str). It can call the reviewer when the user asks for a
review or when a second opinion would help after substantial edits. The reviewer
subagent can inspect files, but it cannot edit files or run commands. Use
--no-reviewer to disable it.
For a short hands-on flow, see TRY_IT.md.