Assumer Environment Variables

Environment variables

Environment variables that change how Assumer behaves: config locations, authentication for CI, permissions, updates, sharing, language servers and logging.

Set these in your shell, CI pipeline or container to change how Assumer behaves.

Configuration

Variable	Effect
`ASSUMER_CONFIG`	Path to a config file to use.
`ASSUMER_CONFIG_DIR`	Directory to load configuration from.
`ASSUMER_CONFIG_CONTENT`	Inline JSON configuration.
`ASSUMER_PERMISSION`	Inline JSON permission rules.
`ASSUMER_DISABLE_PROJECT_CONFIG`	Ignore the project’s `assumer.json`.

Authentication

Variable	Effect
`ASSUMER_CONSOLE_TOKEN`	Authenticate without `assumer login`, for CI and servers. See CI and automation.

Behaviour

Variable	Effect
`ASSUMER_DISABLE_AUTOUPDATE`	Don’t check for updates automatically.
`ASSUMER_DISABLE_AUTOCOMPACT`	Don’t compact long sessions automatically.
`ASSUMER_DISABLE_SHARE`	Turn off session sharing.
`ASSUMER_DISABLE_LSP_DOWNLOAD`	Don’t download language servers.
`ASSUMER_DISABLE_CLAUDE_CODE`	Don’t read Claude Code files (`CLAUDE.md`, `.claude/`).
`ASSUMER_DISABLE_EXTERNAL_SKILLS`	Load only Assumer’s own skills.
`ASSUMER_DISABLE_SDD`	Turn off spec-driven development.
`ASSUMER_DISABLE_MOUSE`	Turn off mouse support in the terminal UI.
`ASSUMER_DISABLE_TERMINAL_TITLE`	Don’t change the terminal window title.

Server

Variable	Effect
`ASSUMER_SERVER_USERNAME` / `ASSUMER_SERVER_PASSWORD`	Protect `assumer serve` with basic auth. See Server.

Windows

Variable	Effect
`ASSUMER_GIT_BASH_PATH`	Path to Git Bash, if it isn’t found automatically. See Windows.

Logging

Variable	Effect
`ASSUMER_LOG_LEVEL`	Log verbosity, for example `DEBUG`.
`ASSUMER_PRINT_LOGS`	Print logs to the terminal.