@pebblehouse/odin-cli

CLI for Odin — the knowledge backbone for Pebble House.

Install

npm install -g @pebblehouse/odin-cli

Setup

# Authenticate via browser (Google sign-in)
odin login

This opens your browser, completes Google OAuth, and stores credentials locally at ~/.odin/credentials.json. Tokens auto-refresh — you won't need to re-login for ~6 months.

Usage

Pebbles

odin pebbles list
odin pebbles get <slug>
odin pebbles create <slug> --name "My Project"
odin pebbles update <slug> --status building

Documents

odin docs list <slug>
odin docs get <slug> <type>
odin docs create <slug> architecture --title "Architecture" --file ./ARCHITECTURE.md
odin docs update <slug> architecture --file ./ARCHITECTURE.md

Decisions

odin decisions list <slug>
odin decisions log <slug> "Use Hono for API" --rationale "Lightweight, consistent"

Context (Tier 1 Retrieval)

odin context <slug>              # Last 20 observations
odin context <slug> --limit 50   # Custom limit

Sessions

odin sessions start <slug>                    # Returns session ID
odin sessions end <session-id> --summary "Completed auth"

Search

odin search "authentication"                  # Cross-pebble
odin search "RLS policies" --pebble odin      # Scoped

Auth

odin login    # Browser OAuth
odin logout   # Clear credentials

Output

All commands output JSON to stdout. Errors go to stderr with non-zero exit codes.

Configuration

| Variable | Default | Description | |----------|---------|-------------| | ODIN_API_URL | https://www.odin.mu | API base URL | | ODIN_SUPABASE_URL | — | Supabase URL (for token refresh) | | ODIN_SUPABASE_ANON_KEY | — | Supabase anon key (for token refresh) |

License

MIT