archgate login

Authenticate with GitHub to access Archgate editor plugins. If you are not registered yet, the CLI handles signup automatically — it prompts for your email, editor preference (Claude Code, Cursor, VS Code, GitHub Copilot, or opencode), and use case, then registers you before completing the login.

archgate login

Starts a GitHub Device Flow (OAuth). The CLI displays a one-time code and a URL. Open the URL in your browser, enter the code, and authorize the Archgate GitHub OAuth App. Once authorized, the CLI exchanges your GitHub identity for an Archgate plugin token and stores it securely in your OS credential manager (macOS Keychain, Windows Credential Manager, or Linux libsecret) via git credential approve. No credentials are written to disk as plain-text files.

If your GitHub account is not yet registered, the CLI prompts for your email, preferred editor, and use case, then signs you up automatically.

Credentials are required to install editor plugins via archgate init --install-plugin. The CLI itself (check, init, etc.) works without login.

Plugin beta

Editor plugins are currently in beta. Run archgate login to sign up and authenticate.

Subcommands

Subcommand	Description
archgate login	Authenticate (skips if already logged in)
archgate login status	Show current authentication status
archgate login logout	Remove stored credentials
archgate login refresh	Re-authenticate and claim a new token

Examples

Log in for the first time:

archgate login

By signing up, you agree to the Archgate Terms of Service:
https://archgate.dev/terms-of-service

info: Authenticating with GitHub...

Open https://github.com/login/device in your browser
and enter the code: ABCD-1234

Waiting for authorization...
info: GitHub user: yourname
info: Claiming archgate plugin token...

Your GitHub account yourname is not yet registered.
Let's sign you up now.

? Email address: [email protected]
? Which editor will you use with archgate? Claude Code
? How do you plan to use archgate? Enforcing ADRs in our monorepo
? I agree to be contacted by the Archgate team to provide feedback during the beta period. Yes

info: Submitting signup request...
info: Claiming archgate plugin token...

info: Authenticated as yourname. Plugin access is now available.
Run `archgate init` to set up a project with the archgate plugin.

If the project already has .archgate/adrs/, the final line reads:

Run `archgate check` to validate your project against its ADRs.

Troubleshooting

TLS/corporate proxy errors

If archgate login fails with a TLS certificate error (common behind corporate proxies), point your runtime at your organization’s CA bundle using the NODE_EXTRA_CA_CERTS environment variable.

On macOS/Linux:

export NODE_EXTRA_CA_CERTS=/path/to/your-corporate-ca.pem
archgate login

On Windows (PowerShell):

$env:NODE_EXTRA_CA_CERTS = "C:\path\to\your-corporate-ca.pem"
archgate login

On Windows (cmd):

set NODE_EXTRA_CA_CERTS=C:\path\to\your-corporate-ca.pem
archgate login

On Windows (Git Bash):

export NODE_EXTRA_CA_CERTS=/c/path/to/your-corporate-ca.pem
archgate login

Ask your IT team for the correct certificate path if you are unsure.

Check login status:

archgate login status

Logged in as yourname.

Log out:

archgate login logout

Re-authenticate:

archgate login refresh