HyperNeo

Claude Code web UI for coding, life, and anything in between.

Screenshots

Desktop and mobile interfaces showing coordinator mode with multi-agent workflow and task management

Run hyperneo in any directory to get a full-featured web interface for Claude right in your browser. Manage multiple conversations at once, switch models on the fly, and let the agent read, write, and run code in your project — all from a clean, responsive UI.

Quick start

npm install -g hyperneo
export ANTHROPIC_API_KEY=sk-ant-...
hyperneo

Open http://localhost:9283 and start a conversation.

Features

• Multi-session conversations — run multiple independent agent sessions side by side
• Model switching — swap between Sonnet, Opus, and Haiku mid-conversation
• File and git operations — the agent reads, writes, and commits within your workspace
• MCP server support — connect external tools via the Model Context Protocol
• Rewind and checkpoints — roll back file changes or conversation history to any point
• Extended thinking — enable thinking mode with configurable token budgets (8k/16k/32k)
• macOS and Linux — native binaries for darwin-arm64, darwin-x64, linux-x64, and linux-arm64

Authentication

Set one of these environment variables before starting:

Variable	Description
ANTHROPIC_API_KEY	Anthropic API key (recommended)
CLAUDE_CODE_OAUTH_TOKEN	OAuth token from Claude Code
OPENROUTER_API_KEY	OpenRouter API key for OpenRouter models
OLLAMA_BASE_URL	Optional local Ollama URL (defaults to http://localhost:11434)
OLLAMA_CLOUD_API_KEY	Ollama Cloud API key
OLLAMA_CLOUD_BASE_URL	Optional Ollama Cloud API URL (defaults to https://ollama.com)

OpenRouter models use provider/model IDs such as anthropic/claude-sonnet-4.6 and openrouter/auto. See OpenRouter setup for provider details and compatibility notes.

Ollama local and Ollama Cloud models use the native /api/chat and /api/tags APIs through HyperNeo's provider bridge. See Ollama setup for local and cloud configuration.

Usage

hyperneo [path] [options]

Option	Default	Description
path	.	Workspace directory
-p, --port	9283	Port to listen on
--host	0.0.0.0	Host to bind to
--db-path	./data/daemon.db	Database location
-V, --version		Show version number

Development

This project uses a dev branch for active development. See CONTRIBUTING.md for details on the branching strategy and contribution guidelines.

Quick overview:

• All feature PRs should target the dev branch
• Releases go directly from dev via version tags
• E2E tests run on-demand via workflow_dispatch

License

Apache-2.0