CLI command reference
The onemind CLI Command Reference lists every shell command, palette action, user role, and sync mode available in the current release.
Navigate The Command Palette
| Input | Result |
|---|---|
| Type text | Filter commands by name or description; fuzzy matching is supported. |
| Up / Down | Move through visible commands. |
| Enter | Run the selected command. |
| Escape | Return from a result screen to the command palette. |
| Backspace / Delete | Remove the last search character. |
| Ctrl+C | Quit onemind from any screen. |
Command Reference
Shell Commands
Run these directly in a macOS or Linux terminal:
| Shell command | Purpose |
|---|---|
onemind | Open the interactive command palette. |
onemind help | Show the direct shell command overview. |
onemind propose "TEXT" | Queue and immediately upload a new Mind entry for admin review. |
onemind propose [--kind KIND] --file PATH | Submit longer Markdown content from a file; use --file - for standard input. --kind names the proposal category (1–64 lowercase letters, digits, hyphens, or underscores; default prompt_observation). |
onemind propose --help | Show proposal input forms and options. |
onemind files | List Mind files for the exact ordinary Project bound to the current directory. This is shorthand for onemind files list. |
onemind files list [--team] [--prefix PATH] [--json] | List the current ordinary Project's Mind files. --team is the explicit safe path to the Team Project. |
onemind files check [--ai TARGET] [--quiet] [--wait] | Compare only Mind files assigned to the exact current Project and AI target with local regular files. It sends identity and SHA-256 metadata, never file content, and creates or polls a device-scoped replacement approval. --wait requires --quiet. |
onemind files upload [--team] --ai TARGET[,TARGET...] [--to MATRIX_PATH] LOCAL_PATH | Submit one UTF-8 .md, .markdown, .txt, .json, .yaml, .yml, or .toml file, or a directory containing only those formats, as Mind file-change proposals. --ai is required and accepts every Mind-assignment upload key listed below; comma-separate multiple targets. Mind main does not change until an admin approves each proposal. |
onemind files download [--team] [--output LOCAL_PATH] [--force] MATRIX_PATH | Download one exact Mind file from the selected Project. --force authorizes this direct download only; it is never treated as governed replacement approval. |
onemind files delete [--team] [--recursive] --yes MATRIX_PATH | Delete one exact Mind file, or a whole path prefix with --recursive, from the selected Project. The explicit --yes confirmation is required. |
onemind projects list [--json] | List every Project visible to the signed-in team. |
onemind projects show PROJECT_ID [--json] | Show one exact Project, including pending edit and Mind file-proposal counts. |
onemind projects create --name NAME --key KEY --goal GOAL --description TEXT [options] | Create an ordinary Project. Admin access is required; use --id, --status, --health, --message, or --json when needed. |
onemind projects edit PROJECT_ID [field options] | Edit selected metadata while preserving existing Project sections and member-tool assignments. Team edits normally become approval drafts. |
onemind projects approve PROJECT_ID DRAFT_ID [--json] | Approve one exact pending Project edit. A current admin may approve their own draft. |
onemind projects reject PROJECT_ID DRAFT_ID [--json] | Reject one exact pending Project edit. Admin access is required. |
onemind project TOOL PROJECT_PATH | Detect the specified directory as a Project-scoped target for Codex, Antigravity, Claude Code, OpenClaw, OpenCode, Hermes Agent, Pi, Grok Build, DeepSeek Harness, Cursor, Qoder, TRAE, or CodeBuddy (workbuddy). The explicit path is required, and the target remains inert until Sync Setup binds an ordinary Project. |
onemind cursor [PROJECT_PATH] | Compatibility shorthand for detecting a Cursor Project target. |
onemind qoder [PROJECT_PATH] | Compatibility shorthand for detecting a Qoder Project target through the repository-root AGENTS.md. |
onemind trae [PROJECT_PATH] | Compatibility shorthand for detecting a TRAE Project target. |
onemind sync | Force a package apply and retry queued proposal uploads. After applying, opens every synced Markdown instruction file in the default app. |
onemind sync-status [--mine | --team] [--json] | Show live machine and AI-tool sync status. |
onemind sync-backup list [--json] | List Mind-sync restore points on this device. |
onemind sync-backup restore ID --yes | Restore instruction files from a Mind-sync backup. |
onemind skills status [--json] | Inspect skills associated with the exact Project and report local state without changing files. |
onemind skills resolve NAME | Resolve one installed current Project skill to its exact verified SKILL.md path for direct use in this running task. |
onemind skills install NAME... | Download, verify, and install only the exact selected uninstalled Project skills. |
onemind skills update NAME... | Verify and update only the exact selected outdated managed skills; previous files go to quarantine. |
onemind skills uninstall NAME... | Uninstall only the exact selected Project-managed skills to recoverable quarantine. |
onemind analyze on | Enable bounded Codex skill and onemind work-history analysis on this device. |
onemind analyze off | Stop local analysis reads immediately and disable cloud consent when reachable. |
onemind analyze status [--json] | Show local consent, cloud consent, and shared Security Check provider status. |
onemind analyze now | Analyze changed supported sources now; analysis must already be enabled. |
onemind status | Print the installed version, connected team, Mind status, and device sync status. |
onemind memory | Preview the approved shared memory. |
onemind review | List knowledge proposals; admin access is required. |
onemind approve ID | Approve a proposal and publish a new shared-memory version; admin access is required. |
onemind reject ID | Reject a proposal; admin access is required. |
onemind mind backups [--path PATH] [--json] | List local Mind backups for an instruction file at the given path. |
onemind mind restore ID --path PATH --file FILENAME [--json] --yes | Restore the pre-onemind backup or a previous applied Mind. Pass pre-onemind as the ID to restore the original pre-onemind file. |
onemind mind-check member --harness PATH[,PATH...] [--subject PATH] [--project ID] [--json] | Run Mind Check Station (member role); warn-only, never blocks sync. |
onemind mind-check manager --subject PATH [--project ID] [--json] | Run Mind Check Station (manager role); warn-only, never blocks sync. |
onemind minds list [--json] | List BETA Minds visible to the signed-in team. |
onemind minds show MIND_ID [--json] | Show one BETA Mind. |
onemind minds create --id ID --name NAME --key KEY --purpose TEXT --file PATH --idempotency-key KEY [--project PROJECT_ID] [--file-name mind.md] [--json] | Create a BETA Mind. Admin access required. |
onemind minds update MIND_ID --file PATH --title TEXT --expected-version N --expected-source-hash HASH [--details TEXT] [--file-name NAME] [--json] | Propose an update to a BETA Mind for Safe Check and review. |
onemind version | Print the installed CLI version. |
onemind update --check | Check the official release channel without changing the installation. |
onemind update | Show the official signed-installer instructions without changing the installation, then exit with action-required status 3. It never replaces only the CLI binary. |
onemind logout | Sign out this CLI session and isolate its local Project data. |
onemind server URL | Configure the onemind API base URL. Changing the server removes the previous server's stored credential; sign in again afterward. |
onemind integrations list [--json] [--app-binding ABSOLUTE_PATH] | List signed integration packages and their state. |
onemind integrations status TARGET [--json] [--host-executable ABSOLUTE_PATH] [--app-binding ABSOLUTE_PATH] | Show one integration's detailed state. |
onemind integrations install TARGET [--json] [--host-executable ABSOLUTE_PATH] [--app-binding ABSOLUTE_PATH] | Install the bundled signed integration for TARGET. |
onemind integrations update TARGET [--json] [--host-executable ABSOLUTE_PATH] [--app-binding ABSOLUTE_PATH] | Update an installed integration to the current signed bundle. |
onemind integrations uninstall TARGET [--json] [--host-executable ABSOLUTE_PATH] [--app-binding ABSOLUTE_PATH] | Uninstall one integration. |
onemind integrations repair TARGET [--json] [--host-executable ABSOLUTE_PATH] [--app-binding ABSOLUTE_PATH] | Repair a damaged or inconsistent integration. |
onemind integrations capabilities --json --app-binding ABSOLUTE_PATH | List integration capabilities for an app binding (macOS app Codex connect flow). |
onemind integrations adopt codex --json --app-binding ABSOLUTE_PATH [--host-executable ABSOLUTE_PATH] | Adopt an existing Codex integration; writes a lifecycle receipt only when the plugin exactly matches the current signed bundle. |
onemind session status | Print non-secret CLI session identity as JSON. |
onemind config restore-pre-v9 | Restore the verified configuration snapshot from before the v9 migration. |
onemind verify-session --tool TOOL [--host-adapter ABSOLUTE_PATH] | Report local instruction-file cryptographic readiness for TOOL, or produce server-accepted fresh-session verification with an explicit authenticated --host-adapter. Local readiness is not host-attested proof. |
onemind verify-release-integration VERSION ARCHIVE SIGSTORE_BUNDLE | Verify the signed AI-tool integration archive without extracting or mutating local state. |
onemind import-signed-integration-release VERSION ARCHIVE SIGSTORE_BUNDLE STORE | Publish an authenticated immutable integration generation. |
onemind install-signed-integration-release VERSION ARCHIVE SIGSTORE_BUNDLE STORE PROFILE_HOME | Install a previously imported signed integration release. |
onemind daemon run | Run the sync daemon in the foreground. Normally the operating-system service runs this. |
onemind service install | Create and register the per-user background service. |
onemind service start | Start the registered service. |
onemind service stop | Stop the registered service. |
onemind service status | Ask the operating system for the service status. A zero exit status means it is available. |
onemind service uninstall | Stop/unregister the service and remove its service definition. It does not delete the CLI binary or project files. |
Command-Palette Actions
Run onemind and select from the displayed items. The palette shows three items when signed in and two when signed out:
| Palette action | What it does | Available to |
|---|---|---|
| Sync | Force a package apply and retry queued proposal uploads. After applying, opens every synced Markdown instruction file in the default app. | Members, admins |
| Status | Print the installed version, connected team, Mind status, and device sync status. | Members, admins |
| Sign out | Revoke this terminal session and remove its stored credential. | Members, admins |
| Sign in | Open browser authorization for this terminal. | Signed-out users |
| Check for updates | Check the official release channel without changing the installation. | Signed-out users |
User Roles
| Capability | Signed out | Member | Admin |
|---|---|---|---|
| Sign in | Yes | — | — |
| Check for updates | Yes | Yes | Yes |
| Connect, inspect, and sync a project | — | Yes | Yes |
| List, upload, download, or delete Mind library files | — | Yes | Yes |
| Enable personal skill/work-history analysis on one device | — | Yes | Yes |
| Read team and activity information | — | Yes | Yes |
| Review knowledge proposals | — | — | Yes |
| Invite, promote, remove, or revoke members (via Team and AI tools) | — | — | Yes |
| Sign out | — | Yes | Yes |
Sync Modes
Each Project target starts syncing once you choose its Project Mind in Sync Setup; from then on, background sync and Sync apply approved memory to it. Older single-project setups also stored an auto, manual or disabled sync mode, which current versions no longer let you change.