Configuration

Use agit config to inspect or change this machine’s AgentGit settings. These settings are global to the AgentGit home, not per-project settings.

Inspect and change a setting

agit config --list
agit config hub.url
agit config runtime.default codex
agit config runtime.default --unset

The last command removes the explicit runtime choice. A bare agit config opens the interactive editor when a terminal is available. Use --list or an explicit key in scripts; add --json for structured output showing effective and stored values and their source.

Available settings

Key	Values and default	Effect
hub.url	Default https://agent-git.com	Hub used by commands; AGIT_HUB_URL takes precedence
runtime.default	claude-code, codex, or opencode; unset falls back to Claude Code for new sessions	Runtime used when an operation needs a default; --as selects a runtime for a particular launch
push.visibility	ask (default), private, or public	First-publication visibility; noninteractive ask chooses private
commit.auto	true (default) or false	Whether supported runtime hooks automatically settle adopted sessions
memory.track	session (default) or off	Whether runtime memory is collected onto session branches
secrets.keystore	os (default) or file	Device-local key storage; file is Unix-only and AGIT_SECRETS_KEYSTORE takes precedence

push.visibility does not change an already published repository’s visibility; use agit repo visibility for that. commit.auto neither installs hooks nor adopts unmanaged conversations, and does not control the RC supervisor’s save and push cycle. See runtime setup, Remote Control, and memory.

Select the right Hub and session

agit login --hub https://hub.example.com
agit config hub.url
agit whoami --check

Use your Hub’s actual address. Login remembers that Hub as the default, while credentials remain scoped to each Hub. If an environment override is set, inspect the effective setting before assuming the stored default is active.

Environment variable	Meaning
AGIT_HOME	AgentGit local data root; defaults to ~/.agit
AGIT_HUB_URL	Overrides the default Hub URL
AGIT_SESSION	Explicit owner/repo@branch identity inherited by commands and MCP
AGIT_SECRETS_KEYSTORE	Overrides the selected secret keystore

Stored settings live in AGIT_HOME/config.json. Use the CLI to validate values instead of editing the file by hand. A runtime launched through AgentGit gets its session identity automatically. For a command in another POSIX shell:

AGIT_SESSION=alice/my-project@first-task agit log @

In PowerShell, set $env:AGIT_SESSION or use the full target directly, such as agit log alice/my-project@first-task. A directory binding does not supply a missing session target. See context selection.

Check installation and updates

agit --version
agit upgrade --check
agit doctor
agit doctor --check-backend

upgrade --check reports availability; agit upgrade installs the announced CLI release. Re-run agit setup to refresh runtime integrations after updating, and reload runtimes as needed. A running RC daemon must be stopped and restarted to use the new binary; stop it only when you are ready to end its sessions.

doctor checks local integrity and runtime support. Add --check-backend for Hub connectivity. A successful local check does not establish that a particular conversation was saved or published; inspect its history and sync status too.