Guides
CLI reference
The everyday commands for a connected local workflow.
Run project-scoped commands from your connected application directory. Replace angle-bracket placeholders with values from your own setup.
This is a focused reference, not an exhaustive listing. Use mindslice --help for the installed version.
Install and update
brew install mindsliceai/tap/mindslice
brew upgrade mindslice
mindslice --versionHomebrew is supported on macOS and Linux. Archives for other installations are available from Mindslice Releases.
After an upgrade, restart a running service to use the new executable.
Local service
mindslice service start
mindslice service status
mindslice service restart
mindslice service stopThe service runs locally and manages homebase registrations and generated context. Starting it does not automatically enable startup at sign-in.
For supported Homebrew installations:
mindslice service enable
mindslice service disable
mindslice settingsenable starts the service and registers startup at sign-in. disable unregisters the managed service. Stopping a Homebrew-managed service also disables its automatic startup so it stays stopped.
Set up a homebase or project
Interactive setup:
mindslice init /path/to/knowledge
mindslice init /path/to/applicationChoose Home / homebase for the knowledge folder and Application project for the code directory if metadata does not already identify them.
To create a new homebase directory explicitly, without initializing Git:
mindslice init --type home --name "Team knowledge" --confirm /path/to/knowledgeUse a suitable new directory and review the path. Flags precede positional paths.
The older connect, hb-init, and hb-connect commands have been removed. Use init instead.
Inspect connections
mindslice status
mindslice status --jsonStatus reports project connections, homebases, view modes, and health. Connection IDs and project IDs are different: use the connection ID for refresh operations.
Find related projects
From a registered homebase:
mindslice projects list --json
mindslice projects resolve --jsonlist reports the homebase’s known projects and cached checkout information. resolve performs bounded local discovery using Mindslice project descriptors. Inspect statuses, paths, search roots, completeness, and issues; unresolved or ambiguous results need a decision.
Use --hb <homebase-id> to select a homebase explicitly, including from an application connected to multiple homebases. To provide a known checkout for one project:
mindslice projects resolve --hb <homebase-id> --project-id <project-id> --path /absolute/application/path --jsonUse IDs from your own setup. The path must match that project’s descriptor and homebase. Discovery does not clone repositories, create connections, change selection, launch agents, or grant filesystem access.
Optionally describe a project’s purpose, responsibilities, and boundaries in the homebase manifest. This helps agents identify likely repositories to investigate; it does not select knowledge or automatically route work.
mindslice projects edit --project-id <project-id>Review the proposed metadata before confirming it. Verify any routing suggestion against the repository’s instructions and source code.
Find and read knowledge
mindslice knowledge tree
mindslice knowledge search "architecture"
mindslice knowledge read <homebase-relative-path.md>These are read-only commands over selected project knowledge. Add --hb <homebase-id> before a positional search or path when the project has multiple homebases.
For long documents and result sets:
mindslice knowledge tree --offset 200 --limit 200
mindslice knowledge read --start-line 201 --end-line 400 <path.md>Use the actual next offset or line range reported by your command. Add --json for structured output.
Refresh a view
mindslice refresh <project-connection-id>Refresh regenerates managed local context. It does not change selection rules or perform remote Git synchronization.
Open the local reader
mindslice reader
mindslice reader --hb <homebase-id>Open the private URL printed by the command. The reader is read-only and local; keep its session URL private.
Review agent integration
mindslice integration check
mindslice integration updateintegration check is a read-only preflight: it works without the service and
reports missing, outdated, modified, or conflicting integration files without
changing them. It checks files, not whether an agent actually loads the
guidance. integration update is write-capable; review its proposed changes
and preserve custom files.
What is not a CLI feature today
The current implementation is experimental. It does not provide ongoing remote Git sync, publishing, cloud accounts, or team administration. Use your normal Git tools for remote collaboration and publishing.
