Configuration

Almost nothing to configure. The agent is interactive by design — run login, pick a mode, and you're done. This page covers the small bit of state it keeps locally and how to wipe it.

## where state lives

The agent keeps a small state directory at ~/.commitly/ with permission mode 0o700 (readable only by your user). It holds non- sensitive preferences and a local queue used for crash resilience.

Secrets are never written here. Your GitHub token, Gemini API key, and Ed25519 private key live exclusively in your OS keychain — see Security model.

## resetting

To wipe local state and start over without uninstalling:

commitly-agent stop
commitly-agent logout
rm -rf ~/.commitly
commitly-agent login

That clears the daemon, removes the credentials from your keychain, and deletes the local state directory. The dashboard-side device record is orphaned but kept; revoke it from the dashboard's Devices page if you want it gone server-side too.