AI Commands

`saedra ai setup`

Configure the AI provider and API key used by AI-powered commands (e.g. saedra memory state update --ai). The configuration is saved to ~/.saedra/ai.json with restricted permissions (0600).

$ saedra ai setup

  AI Setup

? AI provider: > Claude (Anthropic)
                 OpenAI
? Anthropic API key (sk-ant-...): **********************

  AI configured: claude

  Config saved to: /home/user/.saedra/ai.json

If AI is already configured, prompts for confirmation before overwriting.

`saedra ai status`

Show the currently configured AI provider and a masked version of the API key.

$ saedra ai status

  AI Configuration

  Provider: claude
  API Key:  sk-ant-a...3f2d
  Config:   /home/user/.saedra/ai.json

`saedra ai remove`

Remove the AI configuration.

$ saedra ai remove

? Remove AI configuration (claude)? (y/N)

  AI configuration removed.

`saedra ai feature [description]`

Generate architecture-aligned implementation guidance for a feature. Loads the full project context (architecture state, active decisions, recent changes) and sends it alongside your description to the configured AI, streaming the response directly to the terminal.

Requires AI to be configured first via saedra ai setup.

$ saedra ai feature "implement team creation endpoint"
Using project: my-infra (from .saedra)

  AI Feature — Context Injection

  Loading architecture state...   ✓
  Active decisions loaded:        2
  Recent changes loaded:          5
  Sending to AI...

  ──────────────────────────────────────────────────
  Suggestion for: implement team creation endpoint

  ## Analysis
  This feature fits naturally within the existing architecture...

  ## Implementation Plan
  1. Create teams table in Supabase (aligns with DEC-2026-03-09)
  2. Add queries in packages/db-queries/src/teams.ts
  ...

  ## Constraints Applied
  - No direct DB access — all queries go through db-queries
  - TypeScript strict required
  ──────────────────────────────────────────────────

When called without a description argument, prompts interactively:

$ saedra ai feature
? Describe the feature you want to implement: implement team creation endpoint

`saedra --version`

Show the CLI version.

`saedra --help`

List all available commands.

AI Commands

saedra ai setup

saedra ai status

saedra ai remove

saedra ai feature [description]

saedra --version