Skip to content

Repository files navigation

HyperNeo

CICoverage Status

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

Screenshots

HyperNeo Desktop UIHyperNeo Mobile UI

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:

VariableDescription
ANTHROPIC_API_KEYAnthropic API key (recommended)
CLAUDE_CODE_OAUTH_TOKENOAuth token from Claude Code
OPENROUTER_API_KEYOpenRouter API key for OpenRouter models
OLLAMA_BASE_URLOptional local Ollama URL (defaults to http://localhost:11434)
OLLAMA_CLOUD_API_KEYOllama Cloud API key
OLLAMA_CLOUD_BASE_URLOptional 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]
OptionDefaultDescription
path.Workspace directory
-p, --port9283Port to listen on
--host0.0.0.0Host to bind to
--db-path./data/daemon.dbDatabase location
-V, --versionShow 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

About

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

Resources

Contributing

Stars

4 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages