claudear

Reference

CLI commands

Complete command reference for the Claudear CLI.

This is the complete command reference for Claudear. For common workflows and examples, see How it works.
  • claudear start: Start the watcher daemon with all configured services
  • claudear stop: Stop the running watcher daemon
  • claudear status: Show the status of the running daemon
  • claudear pause: Pause the running watcher (stops processing new issues)
  • claudear resume: Resume a paused watcher
  • claudear activity: Show recent activity from the daemon
  • claudear seed: Mark all existing issues as seen
  • claudear dry-run: Show what would be processed without running Claude
  • claudear poll: Start polling all enabled sources (foreground, no daemon)
  • claudear webhook: Start webhook server for real-time events
  • claudear trigger: Manually trigger a fix for an issue
  • claudear reset: Reset a failed attempt to allow retry
  • claudear stats: Show statistics about fix attempts
  • claudear sources: List configured sources
  • claudear dashboard: Start the dashboard API server
  • claudear repos: Repository management commands
  • claudear prs: Pull request management commands
  • claudear retries: Retry management commands
  • claudear inference: Inference analytics and management
  • claudear report: Report generation and scheduling
  • claudear diag: Diagnostic commands for debugging
  • claudear users: User management commands

All commands

Unified watcher for issue trackers and error services

Usage: claudear [OPTIONS] <COMMAND>

Commands:
  start      Start the watcher daemon with all configured services
  stop       Stop the running watcher daemon
  status     Show the status of the running daemon
  pause      Pause the running watcher (stops processing new issues)
  resume     Resume a paused watcher
  activity   Show recent activity from the daemon
  seed       Mark all existing issues as seen
  dry-run    Show what would be processed without running Claude
  poll       Start polling all enabled sources (foreground, no daemon)
  webhook    Start webhook server for real-time events
  trigger    Manually trigger a fix for an issue
  reset      Reset a failed attempt to allow retry
  stats      Show statistics about fix attempts
  sources    List configured sources
  dashboard  Start the dashboard API server
  repos      Repository management commands
  prs        Pull request management commands
  retries    Retry management commands
  inference  Inference analytics and management
  report     Report generation and scheduling
  diag       Diagnostic commands for debugging
  users      User management commands
  help       Print this message or the help of the given subcommand(s)

Options:
  -c, --config <CONFIG>    Path to config file [default: claudear.toml]
      --log-dir <LOG_DIR>  Directory for log files (with daily rotation). Set to empty string to disable file logging [env: CLAUDEAR_LOG_DIR=] [default: ./logs]
  -h, --help               Print help
  -V, --version            Print version

Command reference

claudear start

Start the watcher daemon with all configured services

Start the watcher daemon with all configured services

Usage: claudear start [OPTIONS]

Options:
      --port <PORT>                    HTTP port for dashboard API and webhooks [default: 3100]
      --poll                           Enable background polling (in addition to webhooks)
      --poll-interval <POLL_INTERVAL>  Polling interval in milliseconds (requires --poll) [default: 300000]
      --no-webhooks                    Disable webhook server
      --no-dashboard                   Disable dashboard API
  -h, --help                           Print help

claudear stop

Stop the running watcher daemon

Stop the running watcher daemon

Usage: claudear stop

Options:
  -h, --help  Print help

claudear status

Show the status of the running daemon

Show the status of the running daemon

Usage: claudear status

Options:
  -h, --help  Print help

claudear pause

Pause the running watcher (stops processing new issues)

Pause the running watcher (stops processing new issues)

Usage: claudear pause

Options:
  -h, --help  Print help

claudear resume

Resume a paused watcher

Resume a paused watcher

Usage: claudear resume

Options:
  -h, --help  Print help

claudear activity

Show recent activity from the daemon

Show recent activity from the daemon

Usage: claudear activity [LIMIT]

Arguments:
  [LIMIT]  Number of entries to show [default: 20]

Options:
  -h, --help  Print help

claudear seed

Mark all existing issues as seen

Mark all existing issues as seen

Usage: claudear seed

Options:
  -h, --help  Print help

claudear dry-run

Show what would be processed without running Claude

Show what would be processed without running Claude

Usage: claudear dry-run

Options:
  -h, --help  Print help

claudear poll

Start polling all enabled sources (foreground, no daemon)

Start polling all enabled sources (foreground, no daemon)

Usage: claudear poll [OPTIONS] [INTERVAL]

Arguments:
  [INTERVAL]  Polling interval in milliseconds [default: 300000]

Options:
      --port <PORT>   HTTP port for dashboard API [default: 3100]
      --no-dashboard  Disable dashboard API
  -h, --help          Print help

claudear webhook

Start webhook server for real-time events

Start webhook server for real-time events

Usage: claudear webhook [OPTIONS] [PORT]

Arguments:
  [PORT]  Port to listen on [default: 3100]

Options:
      --setup-webhooks       Auto-configure webhooks with Linear/Sentry APIs before starting
      --base-url <BASE_URL>  Public base URL where webhooks will be received (required with --setup-webhooks)
      --env-file <ENV_FILE>  Path to .env file for saving webhook secrets [default: .env]
  -h, --help                 Print help

claudear trigger

Manually trigger a fix for an issue

Manually trigger a fix for an issue

Usage: claudear trigger <SOURCE> <ISSUE_ID>

Arguments:
  <SOURCE>    Source name (linear, sentry)
  <ISSUE_ID>  Issue ID

Options:
  -h, --help  Print help

claudear reset

Reset a failed attempt to allow retry

Reset a failed attempt to allow retry

Usage: claudear reset <SOURCE> <ISSUE_ID>

Arguments:
  <SOURCE>    Source name (linear, sentry)
  <ISSUE_ID>  Issue ID

Options:
  -h, --help  Print help

claudear stats

Show statistics about fix attempts

Show statistics about fix attempts

Usage: claudear stats

Options:
  -h, --help  Print help

claudear sources

List configured sources

List configured sources

Usage: claudear sources

Options:
  -h, --help  Print help

claudear dashboard

Start the dashboard API server

Start the dashboard API server

Usage: claudear dashboard [OPTIONS] [PORT]

Arguments:
  [PORT]  Port to listen on [default: 3100]

Options:
      --dashboard-dir <DASHBOARD_DIR>  Path to built dashboard files (optional, serves static files)
  -h, --help                           Print help

claudear repos

Repository management commands

Repository management commands

Usage: claudear repos <COMMAND>

Commands:
  list      List all indexed repositories
  index     Build/refresh the repository file index
  search    Search for files across all indexed repositories
  stats     Show index statistics
  link      Link two repositories (declare a dependency)
  graph     Show the dependency graph
  cascade   Show what would cascade from a repository change
  discover  Auto-discover dependencies by scanning directories
  sync      Sync repository index to database (paths and files)
  help      Print this message or the help of the given subcommand(s)

Options:
  -h, --help  Print help

claudear repos list

List all indexed repositories

List all indexed repositories

Usage: claudear repos list

Options:
  -h, --help  Print help

claudear repos index

Build/refresh the repository file index

Build/refresh the repository file index

Usage: claudear repos index [OPTIONS]

Options:
      --force  Force full re-indexing even if already indexed
  -h, --help   Print help

Search for files across all indexed repositories

Search for files across all indexed repositories

Usage: claudear repos search <QUERY>

Arguments:
  <QUERY>  Search query (file name or partial path)

Options:
  -h, --help  Print help

claudear repos stats

Show index statistics

Show index statistics

Usage: claudear repos stats

Options:
  -h, --help  Print help

Link two repositories (declare a dependency)

Link two repositories (declare a dependency)

Usage: claudear repos link [OPTIONS] <UPSTREAM> <DOWNSTREAM>

Arguments:
  <UPSTREAM>    Upstream repository (the dependency)
  <DOWNSTREAM>  Downstream repository (depends on upstream)

Options:
      --dep-type <DEP_TYPE>  Dependency type (npm, composer, git_submodule, manual) [default: manual]
  -h, --help                 Print help

claudear repos graph

Show the dependency graph

Show the dependency graph

Usage: claudear repos graph [OPTIONS]

Options:
      --root <ROOT>  Start from a specific repository
  -h, --help         Print help

claudear repos cascade

Show what would cascade from a repository change

Show what would cascade from a repository change

Usage: claudear repos cascade <REPO>

Arguments:
  <REPO>  Repository that changed

Options:
  -h, --help  Print help

claudear repos discover

Auto-discover dependencies by scanning directories

Auto-discover dependencies by scanning directories

Usage: claudear repos discover [OPTIONS]

Options:
      --paths <PATHS>  Paths to scan (defaults to config's auto_discover_paths)
      --save           Save discovered dependencies to database
      --clear          Clear existing dependencies before saving
  -h, --help           Print help

claudear repos sync

Sync repository index to database (paths and files)

Sync repository index to database (paths and files)

Usage: claudear repos sync [OPTIONS]

Options:
      --skip-files  Skip syncing file lists (faster but limits inference accuracy)
  -h, --help        Print help

claudear prs

Pull request management commands

Pull request management commands

Usage: claudear prs <COMMAND>

Commands:
  list     List all PRs that are being tracked
  monitor  Monitor PRs for merge status and auto-resolve issues
  help     Print this message or the help of the given subcommand(s)

Options:
  -h, --help  Print help

claudear prs list

List all PRs that are being tracked

List all PRs that are being tracked

Usage: claudear prs list

Options:
  -h, --help  Print help

claudear prs monitor

Monitor PRs for merge status and auto-resolve issues

Monitor PRs for merge status and auto-resolve issues

Usage: claudear prs monitor [OPTIONS]

Options:
      --continuous  Run continuously with polling
  -h, --help        Print help

claudear retries

Retry management commands

Retry management commands

Usage: claudear retries <COMMAND>

Commands:
  list     List issues that are eligible for retry
  process  Process ready retries now
  help     Print this message or the help of the given subcommand(s)

Options:
  -h, --help  Print help

claudear retries list

List issues that are eligible for retry

List issues that are eligible for retry

Usage: claudear retries list

Options:
  -h, --help  Print help

claudear retries process

Process ready retries now

Process ready retries now

Usage: claudear retries process

Options:
  -h, --help  Print help

claudear inference

Inference analytics and management

Inference analytics and management

Usage: claudear inference <COMMAND>

Commands:
  stats     Show inference statistics (success rates by confidence level)
  history   List recent inference attempts
  feedback  Provide feedback on an inference attempt
  help      Print this message or the help of the given subcommand(s)

Options:
  -h, --help  Print help

claudear inference stats

Show inference statistics (success rates by confidence level)

Show inference statistics (success rates by confidence level)

Usage: claudear inference stats

Options:
  -h, --help  Print help

claudear inference history

List recent inference attempts

List recent inference attempts

Usage: claudear inference history [OPTIONS]

Options:
      --limit <LIMIT>  Maximum number of entries to show [default: 20]
  -h, --help           Print help

claudear inference feedback

Provide feedback on an inference attempt

Provide feedback on an inference attempt

Usage: claudear inference feedback [OPTIONS] <ID>

Arguments:
  <ID>  Inference attempt ID

Options:
      --correct                    Whether the inference was correct
      --actual-repo <ACTUAL_REPO>  Actual repository name if inference was incorrect
  -h, --help                       Print help

claudear report

Report generation and scheduling

Report generation and scheduling

Usage: claudear report <COMMAND>

Commands:
  preview   Generate and show a report (preview without sending)
  send      Generate and send a report immediately
  schedule  Start the report scheduler (runs in background)
  help      Print this message or the help of the given subcommand(s)

Options:
  -h, --help  Print help

claudear report preview

Generate and show a report (preview without sending)

Generate and show a report (preview without sending)

Usage: claudear report preview [FREQUENCY]

Arguments:
  [FREQUENCY]  Report frequency: daily, weekly, monthly [default: daily]

Options:
  -h, --help  Print help

claudear report send

Generate and send a report immediately

Generate and send a report immediately

Usage: claudear report send [FREQUENCY]

Arguments:
  [FREQUENCY]  Report frequency: daily, weekly, monthly [default: daily]

Options:
  -h, --help  Print help

claudear report schedule

Start the report scheduler (runs in background)

Start the report scheduler (runs in background)

Usage: claudear report schedule [OPTIONS]

Options:
      --daily        Enable daily reports
      --weekly       Enable weekly reports (Monday)
      --hour <HOUR>  Hour to send reports (0-23 UTC) [default: 9]
  -h, --help         Print help

claudear diag

Diagnostic commands for debugging

Diagnostic commands for debugging

Usage: claudear diag <COMMAND>

Commands:
  db             Show database table counts and recent operations
  release-graph  Show the dependency graph used for release tracking
  release-check  Check if a PR's fix would be detected in a target release (dry-run)
  release-path   Show the dependency path from source to target repo
  help           Print this message or the help of the given subcommand(s)

Options:
  -h, --help  Print help

claudear diag db

Show database table counts and recent operations

Show database table counts and recent operations

Usage: claudear diag db

Options:
  -h, --help  Print help

claudear diag release-graph

Show the dependency graph used for release tracking

Show the dependency graph used for release tracking

Usage: claudear diag release-graph

Options:
  -h, --help  Print help

claudear diag release-check

Check if a PR's fix would be detected in a target release (dry-run)

Check if a PR's fix would be detected in a target release (dry-run)

Usage: claudear diag release-check [OPTIONS] <REPO> <PR>

Arguments:
  <REPO>  Repository (owner/repo format)
  <PR>    PR number

Options:
      --target <TARGET>  Target repository to check against (optional, uses config targets if not specified)
  -h, --help             Print help

claudear diag release-path

Show the dependency path from source to target repo

Show the dependency path from source to target repo

Usage: claudear diag release-path <SOURCE> <TARGET>

Arguments:
  <SOURCE>  Source repository (where fix was made)
  <TARGET>  Target repository (where release happens)

Options:
  -h, --help  Print help

claudear users

User management commands

User management commands

Usage: claudear users <COMMAND>

Commands:
  seed  Seed an admin user (creates or updates password if email exists)
  help  Print this message or the help of the given subcommand(s)

Options:
  -h, --help  Print help

claudear users seed

Seed an admin user (creates or updates password if email exists)

Seed an admin user (creates or updates password if email exists)

Usage: claudear users seed [OPTIONS] --email <EMAIL> --password <PASSWORD>

Options:
      --email <EMAIL>        User email
      --password <PASSWORD>  User password
      --name <NAME>          User display name [default: Admin]
  -h, --help                 Print help

#claudear chat

Ask questions about your indexed codebase using a local LLM with RAG-based retrieval. Requires [llm] and [chat] to be enabled.

# Interactive REPL
claudear chat

# Single question
claudear chat "Where is the auth middleware defined?"

# Scope to a specific repo
claudear chat --repo my-org/my-repo "How does retry work?"

# Use a custom model file
claudear chat --model ~/.cache/claudear/models/custom.gguf

# Download the default model if missing
claudear chat --download-model
FlagDescription
[question]Question to ask (omit for interactive REPL mode)
--repo <name>Scope search to a specific repository
--model <path>Path to a GGUF model file (overrides config)
--download-modelDownload the default model if not present
Previous Configuration Next Development
Claudear documentation