cui: Common Agent UI

A modern web UI for your agents. Start the server and access your agents anywhere in your browser. Common Agent UI is powered by Claude Code SDK and supports all kind of LLMs with the most powerful agentic tools.

Highlights

• 🎨 Modern Design: Polished, responsive UI that works anywhere
• ⚡ Parallel Background Agents: Stream multiple sessions simultaneously
• 📋 Manage Tasks: Access all your conversations and fork/resume/archive them
• 🤖 Multi-Model Support: Enjoy power of agentic workflows with any model
• 🔧 Claude Code Parity: Familiar autocompletion and interaction with CLI
• 🔔 Push Notifications: Get notified when your agents are finished
• 🎤 Dictation: Precise dictation powered by Gemini 2.5 Flash

Getting Started

1. With Node.js >= 20.19.0, start the server:

   npx cui-server

   or install it globally:

   npm install -g cui-server

2. Open http://localhost:3001/#your-token in your browser (the token will be displayed in the cui-server command output).

3. Choose a model provider:

   • cui works out of the box with if you have logged in to Claude Code or have a valid Anthropic API key in your environment.
   • Or you can go to settings -> provider and choose a model provider. cui use claude-code-router configurations, supporting different model providers from openrouter to ollama.

4. (Optional) Configure the settings for notifications and dictation.

Usage

Tasks

• Start a New Task

  cui automatically scans your existing Claude Code history in ~/.claude/ and displays it on the home page, allowing you to resume any of your previous tasks. The dropdown menu in the input area shows all your previous working directories.

• Fork a Task

  To create a branch from an existing task (only supported for tasks started from cui), navigate to the "History" tab on the home page, find the session you want to fork, and resume it with new messages.

• Manage Tasks

  Feel free to close the page after starting a task—it will continue running in the background. When running multiple tasks (started from cui), you can check their status in the "Tasks" tab. You can also archive tasks by clicking the "Archive" button. Archived tasks remain accessible in the "Archived" tab.

Dictation

cui uses Gemini 2.5 Flash to provide highly accurate dictation, particularly effective for long sentences. To enable this feature, you'll need a Gemini API key with generous free-tier usage. Set the GOOGLE_API_KEY environment variable before starting the server. Note that using this feature will share your audio data with Google.

Notifications

You can receive push notifications when your task is finished or when Claude is waiting for your permission to use tools. Notifications are sent using either ntfy or native web-push. To receive them, follow the instructions in the settings.

Keyboard Shortcuts

More keyboard shortcuts are coming. Currently available:

• Enter: Enter a new line
• Command/Ctrl + Enter: Send message
• /: List all commands
• @: List all files in the current working directory

All inline syntaxes like /init or @file.txt are supported just like in the CLI.

Remote Access

1. Open ~/.cui/config.json to set the server.host (0.0.0.0) and server.port. Alternatively, you can use --host and --port flags when starting the server.
2. Ensure you use a secure auth token if accessing the server from outside your local network. The auth token is generated when you start the server and can be changed in the ~/.cui/config.json file.
3. Recommended: Use HTTPS to access the server. You can use a reverse proxy like Caddy to set this up. On iOS, the dictation feature is only available when using HTTPS.

Configuration

All configuration and data are stored in ~/.cui/.

• config.json - Server and interface settings
• session-info.db - Session metadata

To uninstall cui, simply delete the ~/.cui/ directory and remove the package with npm uninstall -g cui-server.

Contributing

The best way to contribute is to suggest improvements or report bugs in the issues and give us a star ⭐!

Before submitting a PR, please make sure you (or your fellow AI) have read CONTRIBUTING.md.