CLI Reference

The noodl CLI provides commands for analyzing repositories, managing configurations, and interacting with the noodlbox platform.

Repository Names

Repository names use the owner/repo format. Most commands also accept a path and will resolve to the repository automatically.

# By path (recommended)
noodl search "authentication flow"           # Uses current directory
noodl search "query" /path/to/repo           # Explicit path

# By name
noodl search "query" owner/my-repo           # Reference by name
noodl delete owner/my-repo                   # Delete by name

Core Commands

Commands for analyzing and querying your codebase.

noodl analyze

Analyze a repository and build its knowledge graph.

noodl analyze [OPTIONS] <PATH>

Arguments:

Argument	Description
`<PATH>`	Path to the repository to analyze

Options:

Flag	Description
`--force`	Re-analyze ignoring cached results
`--docs <BOOL>`	Enable markdown documentation analysis (default: false)

Examples:

noodl analyze .                    # Current directory
noodl analyze /path/to/repo        # Absolute path
noodl analyze --force .            # Re-analyze from scratch
noodl analyze --docs true .        # Include markdown docs

noodl list

List all analyzed repositories.

noodl list

noodl delete

Delete analyzed repositories from noodlbox.

noodl delete [OPTIONS] [REPOSITORIES]...

Arguments:

Argument	Description
`[REPOSITORIES]...`	Repository names or paths to delete

Options:

Flag	Description
`-y, --yes`	Skip confirmation prompts

Examples:

noodl delete owner/my-repo              # Delete one repository
noodl delete owner/repo1 owner/repo2    # Delete multiple
noodl delete -y owner/my-repo           # Skip confirmation

noodl schema

Display the knowledge graph schema (node types, relationships, properties).

noodl schema

Used by AI agents to understand the graph structure for queries.

noodl search

Search for code using natural language.

noodl search [OPTIONS] <QUERY> [REPOSITORY]

Arguments:

Argument	Description
`<QUERY>`	Search query (required)
`[REPOSITORY]`	Repository name or path (defaults to current directory)

Options:

Flag	Description
`--limit <N>`	Maximum number of processes to return
`--max-symbols <N>`	Maximum symbols per process
`--include-content`	Include full symbol content in output
`-f, --format <FORMAT>`	Output format: `toon` (default) or `json`

Examples:

noodl search "authentication flow"                    # Search current dir
noodl search "database queries" /path/to/repo         # Search specific repo
noodl search "API handlers" --limit 5                 # Limit results
noodl search "auth" --format json                     # JSON output
noodl search "login" --include-content                # Include full code

noodl search-docs

Search documentation (markdown files, READMEs) using vector, keyword, or hybrid search.

noodl search-docs [OPTIONS] <QUERY> [REPOSITORY]

Arguments:

Argument	Description
`<QUERY>`	Search query (required)
`[REPOSITORY]`	Repository name or path (defaults to current directory)

Options:

Flag	Description
`--mode <MODE>`	Search mode: `vector` (semantic), `fts` (keyword), or `hybrid` (default)
`--limit <N>`	Maximum number of documents to return
`-f, --format <FORMAT>`	Output format: `toon` (default) or `json`

Examples:

# Hybrid search (default - combines semantic + keyword)
noodl search-docs "authentication guide"

# Semantic search only
noodl search-docs "API usage" --mode vector

# Keyword search only
noodl search-docs "README" --mode fts

# With options
noodl search-docs "setup" --limit 10 --format json

noodl query

Execute a Cypher query against the knowledge graph.

noodl query [OPTIONS] <CYPHER> [REPOSITORY]

Arguments:

Argument	Description
`<CYPHER>`	Cypher query (required)
`[REPOSITORY]`	Repository name or path (defaults to current directory)

Options:

Flag	Description
`--limit <N>`	Maximum number of results
`-f, --format <FORMAT>`	Output format: `toon` (default) or `json`

Examples:

noodl query "MATCH (s:CODE_SYMBOL) RETURN s.name LIMIT 10"
noodl query "MATCH (s:CODE_SYMBOL)-[:CALLS]->(t) RETURN s.name, t.name" --limit 20
noodl query "MATCH (c:COMMUNITY) RETURN c" --format json

Account Commands

Commands for authentication and account status.

noodl auth

Authenticate with noodlbox (opens browser).

noodl auth

noodl status

Check authentication and connection status.

noodl status

Setup Commands

Commands for first-time setup and reset.

noodl init

First-time setup for noodlbox. This is the recommended starting point.

noodl init [OPTIONS]

This command:

Creates required directories (~/.noodlbox/state, ~/.noodlbox/repositories)
Authenticates with noodlbox (opens browser)
Configures MCP for your agents (Claude Code, Cursor, Codex, OpenCode)

Options:

Flag	Description
`-y, --yes`	Skip prompts, use defaults

Examples:

noodl init                         # Interactive first-time setup
noodl init -y                      # Non-interactive mode (used by installer)

Note: The installer runs noodl init -y automatically. To start fresh, use noodl reset.

noodl reset

Wipe all noodlbox data and re-run first-time setup.

noodl reset [OPTIONS]

This command:

Removes ~/.noodlbox directory (all data, config, repositories)
Re-runs noodl init for fresh setup

Options:

Flag	Description
`-f, --force`	Skip confirmation prompt

Examples:

noodl reset                        # Interactive (asks for confirmation)
noodl reset -f                     # Skip confirmation

Agent Integration Commands

Commands for configuring AI agent integrations.

noodl configure

Configure AI agents (Claude Code, Cursor, Codex, OpenCode) globally.

noodl configure [OPTIONS]

Configuration is stored in ~/.noodlbox/config.toml and applies to all repositories.

Options:

Flag	Description
`-y, --yes`	Skip prompts, use defaults
`--force`	Reconfigure even if already configured

Examples:

noodl configure                    # Configure agents
noodl configure -y                 # Non-interactive mode
noodl configure --force            # Force reconfigure