Initializing Operalta...

CLI Config

Environment variables, config files, and execution modes

Audience
Developer
Truth
Mixed sources
Surface
CLI
Status
Active

Related documentation: Developer documentation

Environment variables, config files, and execution modes.

A local developer setup for Operalta

How it fits

What CLI configuration controls

Configuration selects identity, context, model, and approval mode without changing the server-side boundary.

  1. Identify

    Credentials

    Choose the login session or key the CLI will use.

    • OAuth
    • API key
    • Provider key
    Open Credentials
  2. selects
    Pin

    Context

    Select the company, network, API URL, or working directory for the run.

    • Company
    • Network
    • URL
    Open Context
  3. configures
    Think

    Model

    Choose the provider and model loop when local or custom reasoning is needed.

    • Default
    • Local
    • Compatible
    Open Model
  4. controls
    Act

    Mode

    Plan, accept edits, or approve automatically according to the risk you accept.

    • Plan
    • Review
    • Auto
    Open Mode

Environment variables

  • OPERALTA_API_KEY — API key.
  • OPERALTA_API_URL — override base URL (default https://www.operalta.ai/api).
  • OPERALTA_COMPANY_ID — pin a company.
  • OPERALTA_NETWORK_ID — pin a personal or investor network for supported network-scoped commands.
  • OPERALTA_MODE — default execution mode.
  • OPERALTA_LLM_PROVIDER=openai-compatible — use a local or remote OpenAI-compatible model endpoint.
  • OPERALTA_LLM_BASE_URL, OPERALTA_LLM_MODEL, OPERALTA_LLM_API_KEY — configure OpenAI-compatible providers such as Ollama, LM Studio, or vLLM.
  • ANTHROPIC_API_KEY, MISTRAL_API_KEY, AWS_REGION — direct provider keys.

Config files

  • Global: ~/.operalta/config.toml.
  • Project: .operalta/config.toml in repo root (overrides global).
  • Order: global → project → env vars → CLI flags.
mode = "plan"
model = "claude-sonnet-5"

[operalta]
apiUrl = "https://www.operalta.ai/api"

[project]
ignorePatterns = ["node_modules", ".git", "dist"]

Modes

  • default — manual approvals.
  • plan — easier reads, writes still confirmed.
  • accept_edits — easier reads and writes.
  • auto_approve — broad auto-approval. Use carefully.