项目文件夹

文件
Devika eb160aae74 Add agent runs viewer and aisuite-code CLI
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>
2026-06-07 20:30:00 -07:00

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.