CLI Reference¶
All commands are available after installation and activating your virtual environment.
Project Management¶
| Command | Description |
|---|---|
dsagt init |
Create or reconfigure a project — interactive menu for name, location, agent, knowledge collections, skill sources, and the episodic-memory opt-in; sets up the KB and writes the per-agent MCP config |
dsagt start <name> |
Launch the agent in the project directory (equivalent to cd <project> && <agent>) |
dsagt info <name> [--json] |
Resolved config (with source per value) and a session/trace summary |
dsagt traces <name> [--port <n>] |
Open the MLflow trace viewer over the project's store (runs catch-up first, deep-links to the Traces tab, quiets the mlflow noise) |
dsagt list |
List all projects with agent and path |
dsagt mv <name> <new-location> |
Move a project to a new location |
dsagt rm <name> [-y] [--keep-files] |
Unregister a project (and optionally delete its directory) |
dsagt smoke-test [--agent claude\|goose\|codex\|opencode\|cline] |
End-to-end install verification |
Deprecated dsagt init flags (backcompat)¶
The pre-menu flags still work — the automation/CI path — but are deprecated in favor of the interactive menu. Each one skips its corresponding prompt:
| Flag | Prompt it replaces |
|---|---|
<name> (positional) |
Project name |
--agent <platform> |
Agent platform |
--location <path> |
Project location |
--include … \| --exclude … |
Knowledge collections / skill sources |
--episodic |
"Enable episodic memory?" |
New usage should prefer bare dsagt init and the menu.
Project Location¶
The default project location is ~/dsagt-projects/<name>/.
Viewing traces¶
The trace store is a serverless SQLite file — browse it with dsagt traces: