Getting started
First run
Start with the installation guide. Packaged installations and development launchers have different startup paths; these steps cover the packaged terminal client.
Launch the terminal client
cercano-cli
The client launches the agent when first used. The macOS packages do not install a login service. You do not need to start the agent binary separately for this personal-use path.
Configure a model source
Cercano ships no models and no credentials. Follow the setup prompts and configure at least one of:
- A cloud provider with the appropriate API credentials or supported subscription sign-in.
- A local model, downloaded on demand. Allow time and disk space for the download.
Provider-specific subscription eligibility and limits apply. See the models and providers guide. The packaged installation does not bundle a local llama/model runtime.
If your organization manages Cercano, follow Connect to Cercloud for the pilot requirements and host-owned authentication flow. Organization policy does not establish that provider credentials are distributed to the client.
Find the controls
Use /help for the current command list, /config for settings, and /theme to select a theme. The TUI guide describes context and subagent views.
Check command versions
cercano --version
cercano-cli --version
Configuration and conversation history for the packaged client live in ~/.config/cercano/, outside the Homebrew installation. Enterprise host state has a separate path; see the connection guide rather than moving or deleting either directory.
Sources: macOS installation, terminal UI guide.