Prime Web

A modern, fast, and feature-rich Web UI for Prime Agent.

English | 中文说明

---

Unofficial community continuation. The original prime-web repository by @wuxiangru915 (a fork of agegr/pi-web) was deleted by its author in September 2026. This repository restores it from a full local clone (main at 9752cc2) and continues it. It is not affiliated with, sponsored by, or endorsed by Prime Intellect or the original authors. See NOTICE for details.

---

Features

• ⚡ Native Prime Agent Integration: Seamlessly connects with your local ~/.prime/agent environment, sessions, models, and authentication.
• 🌳 Interactive Session Tree & Branching: Explore non-linear conversation branches, fork from any message, and switch branches in real time.
• 🧠 Prime Inference & Model Discovery: Built-in native support for Prime Inference, OpenCode Go/Zen, DeepSeek, Claude, OpenAI, and custom OpenAI/Anthropic-compatible endpoints.
• 🎛️ Thinking Level & Tool Presets: Configure reasoning effort per model (off/low/medium/high/max) and control tool execution permissions directly from the chat composer.
• 📁 Integrated Workspace Explorer & Diff Review: Browse files, inspect syntax-highlighted code, preview changes with full git diff support, and manage git worktrees.
• 🎨 Modern Aesthetics & Customization: Clean UI with official Prime branding, dark/light theme toggle, internationalization (EN/ZH), PWA support, and sound notifications.

---

Quick Start

1. Requirements

• Node.js: >= 22.19.0
• Prime Agent: Installed globally (npm install -g prime-agent) or configured locally.

2. Run Locally (One-Command Quick Start)

The easiest way for beginners to start Prime Web:

# Clone the repository
git clone https://github.com/rodericksthescriptkid/prime-web.git
cd prime-web

# One command to start (automatically checks environment, installs dependencies if needed, and starts)
./start.sh

Or start manually via npm:

npm install
npm run dev        # Development mode
# or
npm run serve      # Production build & start

Open http://127.0.0.1:30143 in your browser.

---

Quick Launch CLI & Helper Scripts

Quick Start Script (./start.sh)

Prime Web provides an all-in-one management script:

./start.sh          # Default: Start development mode
./start.sh dev      # Start development mode with hot reload
./start.sh start    # Start production mode (auto-builds if needed)
./start.sh daemon   # Start in background (logs to /tmp/prime-web.log)
./start.sh status   # Check running status & PID
./start.sh stop     # Stop the service
./start.sh restart  # Restart daemon
./start.sh logs     # View live logs

Command Line Shortcut

You can link prime-web to your terminal for fast one-command launch:

# Link globally
npm link

# Launch anywhere
prime-web
# or short alias
pw

---

Configuration & Data Directory

Prime Web uses the standard Prime Agent directory structure:

Item	Path	Description
Sessions	~/.prime/agent/sessions/	JSONL conversation history
Auth	~/.prime/agent/auth.json	API keys and OAuth tokens
Settings	~/.prime/agent/settings.json	Default model, provider, thinking level
Models	~/.prime/agent/models.json	Custom OpenAI/Anthropic provider configurations

---

中文说明

社区续作声明：原 prime-web 仓库（@wuxiangru915 在 agegr/pi-web 基础上的 Prime Agent 移植版）已被原作者于 2026 年 9 月删除。 本仓库由一份完整本地克隆恢复（main 停在 9752cc2）并继续维护，与 Prime Intellect 及原作者没有隶属或背书关系。 详见 NOTICE。

快速开启（新手推荐）

只需一行指令即可完成环境检测、依赖安装与服务启动：

# 克隆仓库并进入目录
git clone https://github.com/rodericksthescriptkid/prime-web.git
cd prime-web

# 一键快速启动
./start.sh

更多启动选项：

• ./start.sh dev：开发模式（带热重载）
• ./start.sh start：生产模式（自动构建产物）
• ./start.sh daemon：后台常驻运行（日志输出至 /tmp/prime-web.log）
• ./start.sh stop：停止服务
• ./start.sh restart：重启后台服务
• ./start.sh status：查看运行状态与 PID
• ./start.sh logs：查看实时日志

功能特点

• 深度适配 Prime Agent：原生对接 ~/.prime/agent 数据目录，零配置读取现有会话、认证密钥与模型设置。
• 树状分支与分支切换：支持非线性多分支对话导航、会话一键 Fork 与多级分支回溯。
• 全量模型生态：全面支持 Prime Inference、OpenCode Go（包含 Muse Spark 1.2 等全系模型）、DeepSeek、Claude 以及自定义兼容端点。
• 思考深度与工具策略：图形化调节模型思维链深度（Thinking Level）与工具预设策略（只读/全功能/纯对话）。
• 工作区与 Git Diff 审阅：内置文件树、代码高亮、Git Worktree 切换及变更审阅。

---

Acknowledgements & Attribution

• Prime Agent: Developed by the Prime Intellect team.
• pi-web: Originally developed by @agegr. Prime Web is ported and adapted from pi-web with full integration for Prime Agent.
• prime-web: Original Prime Agent port by @wuxiangru915. The repository was deleted in September 2026; its 46 commits are preserved in this repository's history.

---

License

MIT. Upstream copyright © 2026 agegr (see LICENSE, kept unchanged); Prime Agent port © 2026 wuxiangru915; this continuation © 2026 the maintainers of this fork. See NOTICE.