Configuration

Workspace settings and environment variables.

Optamus is configured per workspace, with environment variables for secrets.

Workspace config

optamus/config.json in your project:

{
  "model": "default",
  "permissions": {
    "read": "allow",
    "write": "review",
    "shell": "ask"
  },
  "exclude": ["node_modules/", "dist/", "*.lock"]
}

Key	Values	Meaning
`model`	model id	Default model for runs
`permissions.read`	`allow` / `ask`	File and search reads
`permissions.write`	`allow` / `review` / `ask`	File writes
`permissions.shell`	`allow` / `ask`	Shell commands
`exclude`	glob array	Paths the agent never reads

Environment variables

Variable	Purpose
`OPTAMUS_API_KEY`	Hosted API authentication
`OPTAMUS_MODEL`	Overrides the workspace model
`OPTAMUS_LOG`	Log level: `error`, `warn`, `info`, `debug`