Skip to content
OpenCodeHub Docs

Auth & Config

This page covers how authentication and local configuration work in the OpenCodeHub CLI.

Authentication

Section titled “Authentication”

Login

Section titled “Login”
Terminal window
och auth login --url http://localhost:3000

Options:

  • --url <url>: Instance URL (defaults to http://localhost:3000)
  • --with-token: Prompt for a personal access token
  • --token <token>: Non‑interactive token login

Tokens are validated via GET /api/user and are expected to start with the och_ prefix.

Status

Section titled “Status”
Terminal window
och auth status

Shows the authenticated user, server, and token preview.

Logout

Section titled “Logout”
Terminal window
och auth logout

Clears the stored token from your local config.

Configuration

Section titled “Configuration”

The CLI persists settings locally. View the location at any time:

Terminal window
och config path

Common keys

Section titled “Common keys”
  • serverUrl: OpenCodeHub server URL
  • token: Personal access token
  • defaultBranch: Default base branch for PRs (default: main)
  • editor: Editor for interactive input
  • pager: Pager for long output

List & edit

Section titled “List & edit”
Terminal window
och config list
och config get serverUrl
och config set serverUrl https://git.example.com
och config unset editor

Identity shortcut

Section titled “Identity shortcut”
Terminal window
och whoami

A convenience command that validates your token and prints the username.

Shell completions

Section titled “Shell completions”
Terminal window
och completion bash

Supported shells: bash, zsh, fish.