Command reference

base doctor                    # graph health across both tiers; exits nonzero when unhealthy
base doctor --json             # the same report, machine-readable
base config get <key>          # read one config value, dot-notation
base commands list             # every star command currently loaded
base commands show <name>      # the full rules text for one
base operator show             # the operator identity block

base recall --keyword "<term>"            # search notes; also --domain, --slug
base decision search --keyword "<term>"   # prior decisions, with their reasoning
base rule list --domain <domain>          # rules attached to a domain
base project list                         # projects in this workspace
base project list --all                   # across every registered workspace
base project list --json                  # stable JSON, for dashboards
base context "<text>"                     # preview what this text would pull
base context --list                       # every configured trigger

base rule -g list --domain <domain>

base ast list                         # which apps have a code map, and how big
base ast query --contains "<name>"    # entities by name, case-insensitive substring
base ast query --file "<file>"        # everything in one source file
base ast query --calls "<fn>"         # every caller of a named entity
base ast query --imports "<file>"     # every file importing from it
base ast query --target apps/x -c "<name>"   # another app's map, without changing directory

base handoff list        # open handoffs across global and workspace tiers
base fork list           # open forks
base relay board         # sessions, liveness, claims and pending messages
base relay sessions      # titled sessions in the global registry
base relay tasks         # inbound relay tasks across live sessions

base changes --cursor          # the current end offset
base changes --since <offset>  # every write after that offset, as JSON
base changes -g --cursor       # the global tier instead of the workspace

base learn --text "<text>" --domain <domain> --type insight
base decision log --domain <domain> --decision "<what>" --rationale "<why>"
base rule add --domain <domain> --text "<rule>"
base rule add --domain <domain> --text "<rule>" --rationale "<why>"

base project add --name "<name>" --path "src/x"
base milestone add --project <project> --name "<name>"
base task add --project <project> --name "<name>"
base task add --project <project> --name "<name>" --milestone <milestone>
base task done <slug>

base handoff create --project "<project>" --doc "<absolute-path>"
base handoff snooze <slug> <days>
base handoff archive <slug>

base fork create --project "<project>" --doc "<absolute-path>"
base fork snooze <slug> <days>
base fork archive <slug>

base relay register --as <title>                    # title this session
base relay register --as <title> --project <name>   # and tag it with a project

base sync                          # markdown and frontmatter into the graph
base sync --incremental            # only files changed since the last sync
base sync --ast                    # code structure, via tree-sitter
base sync --ast --target apps/x    # a specific directory
base sync --repair                 # backfill missing edges

base scaffold [path]               # create .base/ and register the workspace
base operator init --name "<name>"
base config set <key> <value>      # notable keys: devmode.enabled, multimodal.enabled
base update --check                # is a newer release available
base update                        # install it
base update --snooze               # dismiss the banner for 24 hours

base graph extract --target docs/          # LLM pass over a doc corpus: concepts and edges
base graph query "<question>"              # retrieve and synthesize an answer
base graph query "<question>" --raw        # the retrieved subgraph instead of an answer
base graph analyze                         # god nodes, communities, surprising connections
base graph get-node "<label>"              # full detail for one node
base graph neighbors "<node>" -d 2         # its n-hop neighborhood as edge lines
base graph path "<from>" "<to>"            # shortest path between two nodes

base decision delete --keyword "<keyword>"   # delete matching decisions
base memory purge                            # remove flat-file memories confirmed in the graph
base graph compact                           # dedup and canonicalize; snapshots first
base graph purge --stale                     # drop notes unread past 21 days; PREVIEW unless --apply
base graph purge --stale --days <n> --apply  # a different threshold, actually applied
base graph move                              # move a subgraph between workspaces; PREVIEW unless --yes
base project delete <project>                # refuses a non-empty project unless --force
base uninstall                               # unwire hooks, remove the binary
base uninstall --purge                       # and delete ~/.base-gbl/ as well