Reference

Data and ports

• Data directory — everything lives under ~/.gowork (accounts, credentials, memory, records). Override with GOWORK_CONFIG_DIR.
• Local port — the service listens on 127.0.0.1:8081. Override with PORT.

Account commands

GoWork manages the accounts and API keys behind the gateway. In the app, use the Accounts screen; the same operations are available from the bundled CLI:

• gowork accounts — list accounts
• gowork accounts add — add an account (browser login)
• gowork accounts add --no-browser — add headlessly
• gowork accounts remove — remove an account
• gowork accounts verify — check that accounts are valid

Connecting clients

Point any OpenAI/Anthropic-compatible client or coding CLI at the gateway base URL (http://localhost:8081). See Model gateway for the supported protocols. For agents that speak MCP, GoWork also manages MCP servers — connect them from the app and the assistant can call their tools.

Environment variables

• PORT — local service port (default 8081).
• GOWORK_CONFIG_DIR — data directory (default ~/.gowork).
• GOWORK_CODEX_BIN / GOWORK_CLAUDE_CODE_BIN — override where GoWork finds the Codex / Claude Code executables (normally auto-detected on your PATH).
• GOWORK_ASSISTANT_MAX_ITERATIONS — cap on the assistant's reason–act steps per run.

Notes

• Coding delegation targets Codex and Claude Code. Gemini CLI connects as a gateway client, not a delegation target.
• Desktop automation, IM channels, and offline speech models are optional and are set up from the app.

See also: Getting started · Assistant capabilities · Model gateway