# CLI

`bunx @secondos/cli` (or `npm i -g @secondos/cli`). Key commands:

- `secondos push <path>` — map a repo and sync it (source stays local, K-S23).
- `secondos sync <path> [--deep] [--summarize]` — build the map + semantic index locally.
- `secondos mcp <path>` — start the MCP server for your AI tool.
- `secondos mcp-config` — print ready-to-paste MCP config for Cursor / Claude Code / Windsurf / VS Code.
- `secondos docs <path> [--push]` — write the living docs from the map (needs model creds); `--push` stores the byte-identical docs to the cloud so the web app and `read_living_doc` serve them.
- `secondos ask "<question>"` · `secondos drift` · `secondos watch` · `secondos login`.