Development

# 1. Start the local infrastructure and API
pnpm run dev:infra
pnpm run dev --filter @saedra/cli --filter ./apps/api

# 2. Point CLI to local API
export SAEDRA_API_URL=http://localhost:3002

# 3. Build the CLI (or use dev mode for watch)
pnpm --filter @saedra/cli build
# or
pnpm --filter @saedra/cli dev

# 4. Test commands
node packages/cli/dist/index.js status
node packages/cli/dist/index.js login

packages/cli/
├── package.json
├── tsconfig.json
└── src/
    ├── index.ts            # Entry point - registers all commands
    ├── commands/
    │   ├── login.ts        # Login, config management (getConfig, clearConfig, SaedraConfig)
    │   ├── helpers.ts      # Shared interactive selectors (selectProject, selectDocument)
    │   ├── context.ts      # .saedra context file management (init, findSaedraContext)
    │   ├── projects.ts     # project create / list / delete
    │   ├── documents.ts    # doc create / list / read / edit / push / delete
    │   ├── memory.ts       # memory state view/update/update --ai, decision add/list, change log/list
    │   └── ai.ts           # ai setup / status / remove (getAiConfig, AiConfig, AiProvider)
    └── memory/
        └── schemas.ts      # ArchitectureState, Decision, ChangeEvent, DocumentType

~/.saedra/
├── config.json    # { email, userId, token, apiUrl }
└── ai.json        # { provider, apiKey } — permissions 0600