OpenCodeHub CLI (och)

The OpenCodeHub CLI (och) provides a GitHub CLI-like experience for interacting with OpenCodeHub from the command line.

Installation

npm install -g opencodehub-cli

Quick Start

# 1. Login to your server
och auth login --url http://your-server:3000

# 2. Create a repository
och repo create my-project --description "My new project"

# 3. Push your code
och repo push --branch main

Authentication

och auth login

Login to OpenCodeHub.

och auth login --url http://your-server:3000

Options:

Examples:

# Interactive login
och auth login --url http://localhost:3000

# Non-interactive with token
och auth login --url http://localhost:3000 -t och_xxxxx

# Self-signed TLS
och auth login --url https://git.example.com --ca-file /path/to/ca.pem

och auth logout

Logout from OpenCodeHub.

och auth logout

och auth status

Show current authentication status.

och auth status

Repository Management

och repo create <name>

Create a new repository on OpenCodeHub.

och repo create my-project --description "A cool project"

Options:

och repo clone <repo>

Clone a repository from OpenCodeHub.

och repo clone owner/repo
och repo clone owner/repo my-local-name

Arguments:

och repo push

Push local repository to OpenCodeHub.

och repo push
och repo push --branch main
och repo push --force

Options:

och repo list

List your repositories.

och repo list

Git Operations

och git init

Initialize a repository for OpenCodeHub.

och git init
och git init --url http://your-server:3000

Options:

och git push

Push to OpenCodeHub (shorthand for repo push).

och git push
och git push --branch main --force

och git sync

Sync with remote (fetch + push).

och git sync
och git sync --force

Options:

Pull Requests

och pr create

Create a new pull request.

och pr create
och pr create --title "feat: new feature" --base main

Options:

och pr list

List pull requests.

och pr list
och pr list --state open

Options:

och pr view <number>

View a pull request.

och pr view 42

och pr checkout <number>

Checkout a pull request locally.

och pr checkout 42

och pr merge <number>

Merge a pull request.

och pr merge 42

och pr close <number>

Close a pull request.

och pr close 42

Stacked PRs

och stack create <name>

Create a new branch in the current stack.

och stack create feature/child-1

och stack submit

Push stack and create/update PRs for all branches.

och stack submit

och stack sync

Rebase stack on updated main.

och stack sync

och stack log

Visualize stack tree.

och stack log

och stack status

Show current stack and branch status.

och stack status

Issues

och issue create

Create a new issue.

och issue create --title "Bug: something broken" --body "Description..."

Options:

och issue list

List issues.

och issue list
och issue list --state open

Options:

och issue view <number>

View an issue.

och issue view 42

och issue close <number>

Close an issue.

och issue close 42

Branches

och branch checkout [branch]

Checkout a branch (interactive if no branch specified).

och branch checkout
och branch checkout main

och branch rename [old-name] <new-name>

Rename a branch.

och branch rename old-name new-name

Merge Queue

och queue add <pr-number>

Add a pull request to the merge queue.

och queue add 42

och queue list

List merge queue items.

och queue list

och queue remove <pr-number>

Remove a pull request from the merge queue.

och queue remove 42

CI/CD

och ci list

List pipeline runs.

och ci list

och ci view <run-id>

View a pipeline run.

och ci view run-123

och ci cancel <run-id>

Cancel a pipeline run.

och ci cancel run-123

Releases

och release create <tag>

Create a new release.

och release create v1.0.0 --name "Version 1.0.0" --body "Release notes..."

Options:

och release list

List releases.

och release list

Code Review

och review ai <pr-number>

Trigger AI code review for a pull request.

och review ai 42

och review status <pr-number>

Check AI review status.

och review status 42

Secrets

och secret set <name>

Set a secret.

och secret set MY_SECRET

och secret list

List secrets.

och secret list

och secret delete <name>

Delete a secret.

och secret delete MY_SECRET

Notifications

och notify list

List your notifications.

och notify list

och notify read [id]

Mark notification(s) as read.

och notify read
och notify read notification-id

SSH Keys

och ssh-key add

Add an SSH key to your account.

och ssh-key add

och ssh-key list

List your SSH keys.

och ssh-key list

och ssh-key delete <id>

Delete an SSH key.

och ssh-key delete key-id

Search

och search repos <query>

Search repositories.

och search repos "machine learning"

och search issues <query>

Search issues.

och search issues "bug fix"

Insights

och insights show

Show your developer metrics.

och insights show

och insights team

Show team/repository metrics.

och insights team

Configuration

och config list

List all configuration values.

och config list

och config get <key>

Get a configuration value.

och config get serverUrl

och config set <key> <value>

Set a configuration value.

och config set serverUrl http://localhost:3000

Automations

och automate list

List automation rules for current repository.

och automate list

och automate create

Create a new automation rule.

och automate create

Runner

och runner config

Configure a self-hosted runner interactively.

och runner config

API

och api <endpoint>

Make direct API requests.

och api /api/user
och api /api/repos --method POST --data '{"name": "my-repo"}'

Options:

Focus Mode

och focus

Interactive stack and review cockpit.

och focus

A terminal UI for managing PRs, reviews, and merge queue.

Shell Completions

och completion

Generate shell completions.

# Bash
och completion > ~/.bashrc.d/och-completion.bash

# Zsh
och completion > ~/.zsh/completions/_och

# Fish
och completion --fish > ~/.config/fish/completions/och.fish

Environment Variables

Configuration File

The CLI stores configuration in ~/.config/opencodehub-cli/config.json:

{
  "serverUrl": "http://localhost:3000",
  "token": "och_xxxxx",
  "username": "your-username"
}

Common Workflows

New Repository

och auth login --url http://your-server:3000
mkdir my-project && cd my-project
git init
och repo create my-project --description "My project"
# Add files and commit
och repo push --branch main

Daily Development

och git sync                    # Pull latest changes
och branch checkout feature-x   # Switch branch
# Make changes and commit
och git push                    # Push changes
och pr create --title "feat: X" # Create PR

Stacked PRs

och stack create feature/part-1  # Create first branch
# Work on part 1
och stack submit                  # Push & create PR

och stack create feature/part-2  # Create child branch
# Work on part 2
och stack submit                  # Push & create PR

och stack log                     # View stack hierarchy

Code Review

och pr list                      # See open PRs
och pr checkout 42               # Checkout PR branch
# Review code
och pr merge 42                  # Merge when ready