Operations

CLI reference

atlaso is a CLI as much as a library. Every subcommand mirrors a Memory() method and an MCP tool, so you can debug the same field three ways.

2 min readUpdated May 12, 2026Edit on GitHub

Health & sanity

atlaso version

bash

atlaso version

Prints the installed SDK version.

atlaso check

bash

atlaso check

One-line import check — confirms atlaso and (if installed) atlaso[mcp] resolve.

atlaso doctor

bash

atlaso doctor

End-to-end install diagnostic. Checks import, vendored engine, resolved storage path with source, and runs an add → recall → retract round-trip in a tempdir. Returns 0 on success.

Data operations

Every data subcommand below accepts --json for machine-readable output. --user is the authenticated identity — pass the same value you would pass to Memory.for_user(...), not a value from a request body.

atlaso add

bash

atlaso add "Alice prefers oat milk" --user alice --tag preference
atlaso add "0.7 over-flags in prod" --user alice \
  --polarity negative --evidence observed \
  --scope-note "model=gpt-5; env=prod"

--polarity positive | negative | cautionary | open — default open.
--evidence anecdotal | observed | replicated | verified — default anecdotal.
--scope-note STR, --tag T (repeatable).

atlaso recall

bash

atlaso recall "threshold" --user alice --limit 10 --explain

Prints a verdict line then one row per hit, prefixed with ⚠ for disagreement, ✓ for confident, · otherwise.

atlaso get

bash

atlaso get 7e3a1b2c --user alice

Fetch one deposit by id. Exit 1 if not found.

atlaso list-recent

bash

atlaso list-recent --user alice --limit 50 --offset 0

atlaso peek

bash

atlaso peek alice --limit 10

Note: user_id is positional on peek and health.

atlaso health

bash

atlaso health alice --window 30

atlaso contradict

bash

atlaso contradict "Alice now prefers soy milk" 7e3a1b2c 9c0f1d2a \
  --user alice --reason "Apr-23 conversation update"

Multiple deposit IDs are accepted — they're all marked superseded by the new deposit atomically. --reason is required; an empty string raises InputValidationError.

atlaso retract

bash

# soft (default)
atlaso retract 7e3a1b2c --user alice --reason "user request"

# hard — irreversible
atlaso retract 7e3a1b2c --user alice --reason "GDPR erasure" --hard

--reason is required on retract too.

Operational subcommands

atlaso mcp

bash

atlaso mcp

Starts the FastMCP stdio server. Requires pip install "atlaso[mcp]". See MCP server.

atlaso install-hooks

bash

atlaso install-hooks --scope user
atlaso install-hooks --scope project --project-dir .

Writes ~/.atlaso/hooks/atlaso_recall_hook.sh and atlaso_deposit_hook.sh, then merges UserPromptSubmit + Stopentries into Claude Code's settings.json (user or project scope). Idempotent on rerun.

atlaso uninstall-hooks

bash

atlaso uninstall-hooks --scope user

Removes only the atlaso hook entries from settings.json. Leaves the scripts at ~/.atlaso/hooks/ — delete manually if you want a clean removal.

atlaso demo

bash

atlaso demo

Runs the narrated end-to-end demo. Requires a source checkout (looks for demo.py).

Previous← FAQ NextMCP server →

Was this page helpful?

Operations

CLI reference

atlaso is a CLI as much as a library. Every subcommand mirrors a Memory() method and an MCP tool, so you can debug the same field three ways.

2 min readUpdated May 12, 2026Edit on GitHub

Health & sanity

atlaso version

bash

atlaso version

Prints the installed SDK version.

atlaso check

bash

atlaso check

One-line import check — confirms atlaso and (if installed) atlaso[mcp] resolve.

atlaso doctor

bash

atlaso doctor

End-to-end install diagnostic. Checks import, vendored engine, resolved storage path with source, and runs an add → recall → retract round-trip in a tempdir. Returns 0 on success.

Data operations

atlaso add

bash

atlaso add "Alice prefers oat milk" --user alice --tag preference
atlaso add "0.7 over-flags in prod" --user alice \
  --polarity negative --evidence observed \
  --scope-note "model=gpt-5; env=prod"

--polarity positive | negative | cautionary | open — default open.
--evidence anecdotal | observed | replicated | verified — default anecdotal.
--scope-note STR, --tag T (repeatable).

atlaso recall

bash

atlaso recall "threshold" --user alice --limit 10 --explain

Prints a verdict line then one row per hit, prefixed with ⚠ for disagreement, ✓ for confident, · otherwise.

atlaso get

bash

atlaso get 7e3a1b2c --user alice

Fetch one deposit by id. Exit 1 if not found.

atlaso list-recent

bash

atlaso list-recent --user alice --limit 50 --offset 0

atlaso peek

bash

atlaso peek alice --limit 10

Note: user_id is positional on peek and health.

atlaso health

bash

atlaso health alice --window 30

atlaso contradict

bash

atlaso contradict "Alice now prefers soy milk" 7e3a1b2c 9c0f1d2a \
  --user alice --reason "Apr-23 conversation update"

Multiple deposit IDs are accepted — they're all marked superseded by the new deposit atomically. --reason is required; an empty string raises InputValidationError.

atlaso retract

bash

# soft (default)
atlaso retract 7e3a1b2c --user alice --reason "user request"

# hard — irreversible
atlaso retract 7e3a1b2c --user alice --reason "GDPR erasure" --hard

--reason is required on retract too.

Operational subcommands

atlaso mcp

bash

atlaso mcp

Starts the FastMCP stdio server. Requires pip install "atlaso[mcp]". See MCP server.

atlaso install-hooks

bash

atlaso install-hooks --scope user
atlaso install-hooks --scope project --project-dir .

atlaso uninstall-hooks

bash

atlaso uninstall-hooks --scope user

Removes only the atlaso hook entries from settings.json. Leaves the scripts at ~/.atlaso/hooks/ — delete manually if you want a clean removal.

atlaso demo

bash

atlaso demo

Runs the narrated end-to-end demo. Requires a source checkout (looks for demo.py).

Previous← FAQ NextMCP server →

Was this page helpful?