Command Reference

Comprehensive cheat-sheet for all bevel terminal commands. You can trigger any command below directly, or type them as natural language instructions inside your terminal or the Web Terminal page.

bevelExecution

PRO bridge for non-developers and light developers. Focus on outcomes: setup, health, work, pack, recover, share.

Options Flags:

setupAdopt PRO local layout (dirs, agents, playbook).

healthPlain-English green / amber / red checks.

workOpen product URLs and start shipping.

pack / recover / shareMachine continuity and team Developer Config.

▶Example:bevel health

bevel [query]Core

Primary natural language query trigger. Evaluates your plain English query and routes to the matching action.

Options Flags:

[query]The natural language instruction you want to run.

--helpDisplay general command usage information.

▶Example:bevel "get me set up"

bevel auth loginAuthentication

Initiate Google login, or create a browser approval request for command-line authentication.

Options Flags:

--provider <name>Auth provider: google or web.

--no-openPrint the web approval URL without opening a browser.

▶Example:bevel auth login --provider web

bevel auth grant [request] [code]Authentication

Complete a web permission request after approving it in the dashboard.

Options Flags:

[request]The local request ID printed by auth login --provider web.

[code]The one-time permission code from the web approval URL.

--email <email>The approved dashboard identity.

--name <name>Optional display name for auth status.

▶Example:bevel auth grant req_123 code_456 --email you@example.com

bevel auth statusAuthentication

Display the active profile, auth provider, sync state, configured AI providers, and integrations.

▶Example:bevel auth status

bevel integrations slack <status|connect|test|disconnect>Integrations

Slack complement bridge (digests, slash /bevel, agent cards). Pair with Slack CLI for app shipping: https://docs.slack.dev/tools/slack-cli

Options Flags:

statusShow connection + scopes.

connectPrint OAuth URL (web Extensions).

test [channel]auth.test and optional chat.postMessage.

▶Example:bevel integrations slack connect

bevel auth configure [provider]Authentication

Store an AI provider key in the encrypted local credential vault.

Options Flags:

[provider]One of claude, openai, gemini, grok, or kimi (Kimi3).

▶Example:bevel auth configure gemini

bevel auth logoutAuthentication

Sign out of your active bevel profile and purge local session keys.

▶Example:bevel auth logout

bevel ai ask [question]Core

Ask the configured AI provider, or route to a specific provider.

Options Flags:

--provider <name>Provider: claude, openai, gemini, grok, kimi (Kimi3), or auto.

--model <id>Use a specific model ID.

--temperature <num>Adjust response creativity.

▶Example:bevel ai ask --provider openai "summarize this repo"

bevel ai modelsCore

List models exposed by configured AI providers.

Options Flags:

--provider <name>Filter to one configured provider.

▶Example:bevel ai models --provider claude

bevel clickup tasksIntegrations

Fetch and list active tasks from connected ClickUp workspaces.

Options Flags:

--status <name>Filter tasks by status (to-do, in-progress, completed).

--limit <num>Maximum number of tasks to return (default 10).

▶Example:bevel clickup tasks --status in-progress

bevel github reposIntegrations

List connected GitHub repositories, including stars, forks, and sync states.

Options Flags:

--limit <num>Maximum number of repositories to list.

--syncForce complete index sync prior to printing.

▶Example:bevel github repos --limit 5

bevel workflow trigger [id]Workflows

Trigger a specified local or cloud automated swim lane pipeline workflow.

Options Flags:

[id]The unique identifier ID of the workflow to run.

--dry-runSimulate executing workflow nodes without hitting API endpoints.

▶Example:bevel workflow trigger pr_review

bevel workflow listWorkflows

Print a list of all locally registered workflow pipelines and templates.

▶Example:bevel workflow list

bevel server startServer

Launch the local FastAPI server background daemon supporting Next.js web dashboard controls.

Options Flags:

--port <number>Specify port to listen on (default 43003).

--host <ip>Force listen IP bind (default 127.0.0.1).

--reloadEnable hot-reloading for local FastAPI dev work.

▶Example:bevel server start --port 43003

bevel server statusServer

Check diagnostic connection health and process ID of the background server daemon.

▶Example:bevel server status