kusaw atlas

Build and inspect the local code index

Usage

Text

kusaw atlas [flags]

Flags

Name	Short	Type	Default	Description
`--config`		string		Path to kusaw.yaml (overrides KUSAW_CONFIG and parent search)
`--factory`		string		factory name from kusaw list
`--help`	-h	bool	false	help for atlas

Subcommands

kusaw atlas build

Create an Atlas for configured repos

Text

kusaw atlas build [flags]

Name	Short	Type	Default	Description
`--config`		string		Path to kusaw.yaml (overrides KUSAW_CONFIG and parent search)
`--factory`		string		factory name from kusaw list
`--help`	-h	bool	false	help for build
`--repo`		string		Build one repo label
`--yes`		bool	false	Confirm the build without a prompt

Example:

Text

kusaw atlas build --factory demo

kusaw atlas call

Call read_map or search_code inside a step attempt

Text

kusaw atlas call <tool> [flags]

Name	Short	Type	Default	Description
`--config`		string		Path to kusaw.yaml (overrides KUSAW_CONFIG and parent search)
`--factory`		string		factory name from kusaw list
`--help`	-h	bool	false	help for call
`--json`		string		JSON object of tool arguments

Example:

Text

kusaw atlas call read_map --json '{}'

kusaw atlas experiment

Compare benchmark replays with Atlas on and off

Text

kusaw atlas experiment [flags]

Name	Short	Type	Default	Description
`--config`		string		Path to kusaw.yaml (overrides KUSAW_CONFIG and parent search)
`--factory`		string		factory name from kusaw list
`--help`	-h	bool	false	help for experiment

Example:

Text

kusaw atlas experiment run --factory demo --bench fix-login,add-flag

kusaw atlas experiment cancel

Cancel the experiment's queued replays

Text

kusaw atlas experiment cancel <id> [flags]

Name	Short	Type	Default	Description
`--config`		string		Path to kusaw.yaml (overrides KUSAW_CONFIG and parent search)
`--factory`		string		factory name from kusaw list
`--help`	-h	bool	false	help for cancel

Example:

Text

kusaw atlas experiment cancel ax-20261114-fix-login --factory demo

kusaw atlas experiment list

List Atlas experiments, newest first

Text

kusaw atlas experiment list [flags]

Name	Short	Type	Default	Description
`--config`		string		Path to kusaw.yaml (overrides KUSAW_CONFIG and parent search)
`--factory`		string		factory name from kusaw list
`--help`	-h	bool	false	help for list
`--json`		bool	false	Print JSON

Example:

Text

kusaw atlas experiment list --factory demo

kusaw atlas experiment remove

Delete the experiment's pinned Atlas copies

Text

kusaw atlas experiment remove <id> [flags]

Name	Short	Type	Default	Description
`--config`		string		Path to kusaw.yaml (overrides KUSAW_CONFIG and parent search)
`--factory`		string		factory name from kusaw list
`--help`	-h	bool	false	help for remove
`--yes`		bool	false	Confirm the delete without a prompt

Example:

Text

kusaw atlas experiment remove ax-20261114-fix-login --factory demo --yes

kusaw atlas experiment report

Write report.md and report.json and print the summary table

Text

kusaw atlas experiment report <id> [flags]

Name	Short	Type	Default	Description
`--config`		string		Path to kusaw.yaml (overrides KUSAW_CONFIG and parent search)
`--factory`		string		factory name from kusaw list
`--help`	-h	bool	false	help for report
`--json`		bool	false	Print report.json instead of the table

Example:

Text

kusaw atlas experiment report ax-20261114-fix-login --factory demo

kusaw atlas experiment run

Pin the Atlas at each task's start commit and queue atlas-on and atlas-off replays

Text

kusaw atlas experiment run [flags]

Name	Short	Type	Default	Description
`--bench`		string		Comma-separated benchmark task names
`--budget`		float64	10	Experiment budget in USD, split evenly over the tasks
`--config`		string		Path to kusaw.yaml (overrides KUSAW_CONFIG and parent search)
`--factory`		string		factory name from kusaw list
`--help`	-h	bool	false	help for run
`--model`		string		Model for both arms (default: the factory's)
`--provider`		string		Provider for both arms (default: the factory's)
`--repeat`		int	3	Replays of each arm per task, from 1 to 20
`--yes`		bool	false	Confirm the pinned copies and replays without a prompt

Example:

Text

kusaw atlas experiment run --factory demo --bench fix-login,add-flag --repeat 3 --budget 10

kusaw atlas experiment show

Show one Atlas experiment

Text

kusaw atlas experiment show <id> [flags]

Name	Short	Type	Default	Description
`--config`		string		Path to kusaw.yaml (overrides KUSAW_CONFIG and parent search)
`--factory`		string		factory name from kusaw list
`--help`	-h	bool	false	help for show
`--json`		bool	false	Print JSON

Example:

Text

kusaw atlas experiment show ax-20261114-fix-login --factory demo

kusaw atlas install-hook

Add a notify block to the repo's git hooks

Text

kusaw atlas install-hook [flags]

Name	Short	Type	Default	Description
`--config`		string		Path to kusaw.yaml (overrides KUSAW_CONFIG and parent search)
`--factory`		string		factory name from kusaw list
`--help`	-h	bool	false	help for install-hook
`--repo`		string		Repo label

Example:

Text

kusaw atlas install-hook --factory demo --repo api

kusaw atlas refresh

Refresh an Atlas to the current local main commit

Text

kusaw atlas refresh [flags]

Name	Short	Type	Default	Description
`--config`		string		Path to kusaw.yaml (overrides KUSAW_CONFIG and parent search)
`--factory`		string		factory name from kusaw list
`--help`	-h	bool	false	help for refresh
`--repo`		string		Refresh one repo label
`--yes`		bool	false	Confirm the refresh without a prompt

Example:

Text

kusaw atlas refresh --factory demo --repo api

kusaw atlas remove

Delete a repo's Atlas from the factory data folder

Text

kusaw atlas remove [flags]

Name	Short	Type	Default	Description
`--config`		string		Path to kusaw.yaml (overrides KUSAW_CONFIG and parent search)
`--factory`		string		factory name from kusaw list
`--help`	-h	bool	false	help for remove
`--repo`		string		Repo label whose Atlas to delete
`--yes`		bool	false	Confirm the delete without a prompt

Example:

Text

kusaw atlas remove --repo api --yes

kusaw atlas search

Search the local Atlas index

Text

kusaw atlas search <query> [flags]

Name	Short	Type	Default	Description
`--config`		string		Path to kusaw.yaml (overrides KUSAW_CONFIG and parent search)
`--factory`		string		factory name from kusaw list
`--help`	-h	bool	false	help for search
`--json`		bool	false	Print JSON
`--kind`		string	all	code, map, or all
`--limit`		int	10	Maximum hits (default 10, maximum 50)
`--path`		string		Limit hits to this path prefix
`--repo`		string		Limit search to one repo label

Example:

Text

kusaw atlas search --factory demo --repo api "retry backoff" --json

kusaw atlas status

Show Atlas state for each repo without starting work

Text

kusaw atlas status [flags]

Name	Short	Type	Default	Description
`--config`		string		Path to kusaw.yaml (overrides KUSAW_CONFIG and parent search)
`--factory`		string		factory name from kusaw list
`--help`	-h	bool	false	help for status
`--json`		bool	false	Print JSON
`--repo`		string		Limit output to one repo label

Example:

Text

kusaw atlas status --factory demo --json

kusaw atlas uninstall-hook

Remove the Atlas notify block from the repo's git hooks

Text

kusaw atlas uninstall-hook [flags]

Name	Short	Type	Default	Description
`--config`		string		Path to kusaw.yaml (overrides KUSAW_CONFIG and parent search)
`--factory`		string		factory name from kusaw list
`--help`	-h	bool	false	help for uninstall-hook
`--repo`		string		Repo label

Example:

Text

kusaw atlas uninstall-hook --factory demo --repo api

Exit codes

Code	Name	Description
0	ok	Success.
1	error	Runtime error.
2	usage	Usage or validation error.
3	rejected	Control request rejected; the error string is printed verbatim.
4	not picked up	Control request not picked up within the wait time while serve runs.

Example

Text

kusaw atlas status

kusaw atlas

kusaw atlasCopy Anchor Link

UsageCopy Anchor Link

FlagsCopy Anchor Link

SubcommandsCopy Anchor Link

kusaw atlas buildCopy Anchor Link

kusaw atlas callCopy Anchor Link

kusaw atlas experimentCopy Anchor Link

kusaw atlas experiment cancelCopy Anchor Link

kusaw atlas experiment listCopy Anchor Link

kusaw atlas experiment removeCopy Anchor Link

kusaw atlas experiment reportCopy Anchor Link

kusaw atlas experiment runCopy Anchor Link

kusaw atlas experiment showCopy Anchor Link

kusaw atlas install-hookCopy Anchor Link

kusaw atlas refreshCopy Anchor Link

kusaw atlas removeCopy Anchor Link

kusaw atlas searchCopy Anchor Link

kusaw atlas statusCopy Anchor Link

kusaw atlas uninstall-hookCopy Anchor Link

Exit codesCopy Anchor Link

ExampleCopy Anchor Link

On this page

kusaw atlas

Usage

Flags

Subcommands

kusaw atlas build

kusaw atlas call

kusaw atlas experiment

kusaw atlas experiment cancel

kusaw atlas experiment list

kusaw atlas experiment remove

kusaw atlas experiment report

kusaw atlas experiment run

kusaw atlas experiment show

kusaw atlas install-hook

kusaw atlas refresh

kusaw atlas remove

kusaw atlas search

kusaw atlas status

kusaw atlas uninstall-hook

Exit codes

Example