Codekin

codekin.ai

Web UI for Claude Code, OpenCode, and OpenAI Codex sessions — multi-provider AI coding with multi-session support, WebSocket streaming, file uploads, and slash-command skills.

Install

Prerequisites:

• macOS or Linux
• Node.js v20+ (the install script can install this for you via nvm)
• Claude Code CLI installed and authenticated (claude must be in your PATH)
• (Optional) OpenCode installed for multi-provider LLM support
• (Optional) OpenAI Codex CLI installed and authenticated (codex login) to use ChatGPT-subscription OpenAI models

One-liner:

curl -fsSL codekin.ai/install.sh | bash

This will:

1. Install Node.js 20+ if needed (via nvm)
2. Install the codekin npm package globally
3. Generate an auth token
4. Install and start a persistent background service
5. Print your access URL

Open the printed URL in your browser, enter your Codekin Web token when prompted, and you're ready to go.

Usage

codekin token                   # Print your access URL at any time
codekin config                  # Update API keys and settings
codekin service status          # Check whether the service is running
codekin service install         # (Re-)install the background service
codekin service uninstall       # Remove the background service
codekin start                   # Run in foreground (for debugging)
codekin stop                    # Stop the running background service
codekin setup --regenerate      # Generate a new auth token
codekin upgrade                 # Upgrade to latest version
codekin uninstall               # Remove Codekin entirely

Features

• Multi-provider AI — Use Claude Code, OpenCode, or OpenAI Codex as the backend per session. OpenCode enables any LLM provider (OpenAI, Gemini, etc.) through a single interface; Codex unlocks ChatGPT-subscription OpenAI models — all with full streaming, tool events, plan mode, and permission control
• Multi-session terminal — Open and switch between multiple coding sessions, one per repo
• Agent Joe — AI orchestrator agent that spawns and manages up to 5 concurrent child sessions, with a dedicated chat UI, welcome screen, and color-coded sidebar status indicators. Resilient by design: realtime blocked-child notifications, a persistent notification outbox that replays when the orchestrator returns, pausable child timeouts, and ground-truth completion verification
• Loops — Durable, event-sourced outcome loops that run a coding agent until deterministic evaluators pass (your own build/test/lint commands, judged by exit code), under turn/cost/wall-time budgets with no-progress detection. An independent second provider reviews the diff before it lands, every transition is an auditable event with retained evidence artifacts, runs survive server restarts (pause/resume/steer included), and a passing run is committed, pushed and opened as a PR by Codekin itself. Ships with CI Autorepair, Coverage Increase, and Dependency Upgrade recipes
• Git worktrees — Isolate sessions in dedicated worktree directories, with mid-session creation, auto-enable setting, and session context preservation
• Session archive — Full retrieval and re-activation of archived sessions
• Repo browser — Auto-discovers local repos and GitHub org repos
• Screenshot upload — Drag-and-drop or paste images; the file path is sent to the AI so it can read them natively
• Skill browser — Browse and invoke /skills defined in each repo's .claude/skills/, with inline slash-command autocomplete
• Diff viewer — Side panel showing staged/unstaged file changes with per-file discard support
• Command palette — Ctrl+K to quickly search repos, sessions, skills, docs, archived sessions, and actions
• Approval management — Persistent approval storage with per-permission revoking, permission mode selector, per-session tool pre-approvals, and --dangerously-skip-permissions mode for sandboxed environments
• Dynamic model discovery — New Claude models appear automatically without code changes, discovered via the Anthropic API or CLI alias probing (works with both API-key and subscription auth)
• Connection status — Real-time provider health indicators with disable/enable toggles for each backend
• Subscription & API key auth — Works with both Claude subscription (OAuth) and API key authentication
• Mobile-friendly — Responsive layout that works on phones and tablets, with touch-sized controls
• Light & dark themes — Both polarities are tuned against WCAG AA contrast, switchable in Settings
• Markdown browser — Browse and view .md files directly in the UI
• AI Workflows — Scheduled code and repository audits and maintenance, with support for custom workflows defined as Markdown files
• GitHub webhooks — Automated bugfixing on CI failures and PR code review via webhook integration
• Upgrade notifications — In-app banner when a newer version is available

Upgrade

codekin upgrade

This checks npm for the latest version, installs it, and restarts the background service if running.

Alternatively, re-run the install script:

curl -fsSL codekin.ai/install.sh | bash

Uninstall

codekin uninstall

This removes the background service, config files, and the npm package.

Configuration

All configuration lives in ~/.config/codekin/env. Edit this file to override defaults, then restart the service with codekin service install.

Variable	Default	Description
PORT	32352	Server port
REPOS_ROOT	~/repos	Root directory scanned for local repositories

Manual / Advanced Setup

For remote servers, custom nginx, or other advanced setups, see docs/INSTALL-DISTRIBUTION.md.

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

License

MIT