spectrai-initiative/innoclaw/innoclaw-cli

InnoClaw CLI

Use the innoclaw command from the repository root for local operation.

Bare innoclaw starts the interactive CLI and treats the current shell directory as the workspace.

Interactive and auth

innoclaw
innoclaw auth status
innoclaw auth login
innoclaw auth logout

• The CLI auto-starts the local app on localhost:3000 when needed.
• When auth is enabled, the CLI opens the browser login page and waits for a dedicated CLI session handoff.
• For trusted headless and CI-style runs, start the app with npm run dev:no-auth or AUTH_MODE=disabled.

Non-interactive agent runs

innoclaw run --prompt "Summarize this workspace"
printf 'Create a plan for the current repo' | innoclaw run
innoclaw batch --input jobs.json --workers 4

Command groups

App lifecycle

innoclaw doctor
innoclaw app dev
innoclaw app build
innoclaw app lint
innoclaw app test
innoclaw app start

Workspace management

innoclaw workspace list
innoclaw workspace add --name notebooklm --path "$PWD"

Deep Research

innoclaw research list --workspace-id <workspace-id>
innoclaw research create --workspace-id <workspace-id> --title "Survey of time-series Transformer architectures" --content "Write a deep research report."
innoclaw research show --session-id <session-id>
innoclaw research run --session-id <session-id>
innoclaw research export --session-id <session-id>

Base URL

• Defaults to http://localhost:3000
• Override with --base-url or INNOCLAW_BASE_URL

Usage notes

• research create, research run, and research export use the same local app runtime and auth flow as innoclaw.
• workspace add expects a filesystem path that already exists on disk.
• innoclaw, run, and batch auto-bind the current shell directory as a workspace if needed.
• The CLI stays thin: it wraps the existing local app and HTTP APIs rather than bypassing them.