CLI Commands

Complete reference for every Remb CLI command with flags, examples, and output formats.

remb init

Initialize a project in the current directory. Creates .remb.yml and generates a REMB.md with AI integration instructions.

remb init

remb save

Save a context entry for a project feature.

remb save -f auth -c "Auth uses JWT with RS256 signatures"
remb save -f payments -c "Stripe integration" -t "stripe,billing" -p my-project

Flag	Short	Description	Required
`--feature`	`-f`	`Feature or module name`	`Yes`
`--content`	`-c`	`Context content text`	`Yes`
`--project`	`-p`	`Project slug (reads .remb.yml)`	`No`
`--tags`	`-t`	`Comma-separated tags`	`No`
`--type`		`Entry type (default: manual)`	`No`

remb get

Retrieve context entries with optional filtering.

remb get
remb get -f auth
remb get -p my-project --format json --limit 50

Flag	Short	Description	Default
`--project`	`-p`	`Project slug`	`.remb.yml`
`--feature`	`-f`	`Filter by feature`	`—`
`--limit`	`-l`	`Max entries`	`10`
`--format`		`Output: table, json, markdown`	`table`

remb bundle

Get the full project context bundle — memories, features, tech stack — as a single markdown document. Useful for piping into AI prompts.

remb bundle
remb bundle -p my-project --format json
remb bundle | pbcopy  # copy to clipboard

Flag	Short	Description	Default
`--project`	`-p`	`Project slug`	`.remb.yml`
`--format`		`Output: markdown, json`	`markdown`

remb scan

Trigger a server-side scan of your project via GitHub. Runs the full 5-phase AI pipeline (Scout → Analyze → Architect → Review → Finalize) on the Remb worker and polls progress back to your terminal.

remb scan                # Scan project from .remb.yml
remb scan -p my-project   # Specific project
remb scan --no-poll       # Trigger and exit immediately

Flag	Short	Description	Default
`--project`	`-p`	`Project slug`	`.remb.yml`
`--no-poll`		`Trigger scan and exit (no progress polling)`	`false`

remb push

Same as remb scan but first checks git status (current branch + latest commit SHA) before triggering. Both commands call the same 5-phase cloud pipeline and poll progress.

remb push
remb push --force       # skip git checks
remb push --no-progress  # don't poll for progress

Flag	Short	Description	Default
`--project`	`-p`	`Project slug`	`.remb.yml`
`--force`		`Skip git checks`	`false`
`--no-progress`		`Don't poll for progress`	`false`

remb status

Check the progress of a running or completed scan.

remb status <scan-id>
remb status <scan-id> --format json
remb status <scan-id> --watch  # poll until done

Flag	Description	Default
`--format`	`Output: table, json`	`table`
`--watch`	`Poll continuously until scan completes`	`false`

remb history

View conversation history — what AI discussed and accomplished across sessions.

remb history
remb history --date 2026-04-14
remb history --from 2026-04-01 --to 2026-04-14
remb history --search "authentication" --format json

Flag	Short	Description	Default
`--project`	`-p`	`Project slug`	`.remb.yml`
`--date`	`-d`	`Filter by date (YYYY-MM-DD)`	`—`
`--from`		`Start date filter`	`—`
`--to`		`End date filter`	`—`
`--limit`	`-l`	`Max entries`	`20`
`--format`		`Output: timeline, markdown, json`	`timeline`
`--search`	`-s`	`Semantic search query`	`—`

remb log

Record a conversation entry — log what was discussed or accomplished.

remb log -c "Implemented JWT refresh token rotation"
remb log -c "Fixed auth bug" --type bug-fix --tags "auth,security"
remb log -c "Session summary" -p my-project

Flag	Short	Description	Required
`--content`	`-c`	`What was done/discussed`	`Yes`
`--project`	`-p`	`Project slug`	`No`
`--type`		`Entry type (task-completed, bug-fix, decision, etc.)`	`No`
`--tags`	`-t`	`Comma-separated tags`	`No`

remb memory

Manage persistent AI memories. Alias: remb mem.

# Create a memory
remb memory add -t "Auth uses JWT" -c "RS256 signatures with refresh tokens"
remb memory add -t "API Pattern" -c "All endpoints use Zod validation" --tier core --category pattern

# List memories
remb memory list
remb memory list --tier core --format json
remb memory list --search "authentication" -p my-project

# Update a memory
remb memory update <id> -t "New title" -c "New content"

# Delete a memory
remb memory delete <id>

# Promote to higher tier
remb memory promote <id> --to core

Subcommand	Description
`add`	`Create a new memory`
`list (ls)`	`List memories with filters`
`update`	`Update an existing memory`
`delete (rm)`	`Delete a memory by ID`
`promote`	`Change tier (archive → active → core)`
`stats`	`Show memory usage statistics`
`search`	`Semantic search across memories`

remb projects

Manage projects. Alias: remb proj.

# List all projects
remb projects list
remb projects list --format json --status active

# Get project details
remb projects get my-project

# Create a project
remb projects create "My Project" --repo https://github.com/user/repo

# Delete a project (requires confirmation)
remb projects delete my-project --confirm

Subcommand	Description
`list (ls)`	`List all projects with feature/entry counts`
`get`	`Get project details, features, and scan info`
`create`	`Create a new project`
`delete`	`Delete a project and all its data`

remb skills

Manage AI skill files installed in your project for IDE integration.

# List available skills
remb skills list

# Install skills
remb skills add remb-context remb-memory
remb skills add --all

# Remove a skill
remb skills remove remb-context

# Update installed skills
remb skills update

Skills are installed to both .github/copilot-skills/ (VS Code) and .claude/commands/ (Claude Code).

remb serve

Start a local MCP (Model Context Protocol) server that proxies to the Remb API. AI tools connect via stdio JSON-RPC.

remb serve
remb serve --project my-project

The MCP proxy forwards all requests to the server, so it automatically supports all 100 tools without any hardcoded definitions.

remb import

Import context from existing documentation files into Remb.

remb import README.md
remb import docs/ --recursive
remb import ARCHITECTURE.md -f architecture

remb link

Create dependency links between features in the knowledge graph.

remb link auth payments  # auth depends on payments
remb link -p my-project auth database