# onecode-app

**Repository Path**: onescience-ai/onecode-app

## Basic Information

- **Project Name**: onecode-app
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: AGPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-13
- **Last Updated**: 2026-07-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<p align="center">
  <img src="packages/desktop/assets/icon.png" width="64" height="64" alt="OneCode logo">
</p>

<h1 align="center">OneCode</h1>

<p align="center">
  <a href="README.md">English</a> ·
  <a href="README.zh-CN.md">简体中文</a>
</p>

<p align="center">
  <a href="https://gitee.com/onescience-ai/onecode-app/stargazers">
    <img src="https://img.shields.io/github/stars/onescience-ai/onecode-app?style=flat&logo=github" alt="GitHub stars">
  </a>
  <a href="https://gitee.com/onescience-ai/onecode-app/releases">
    <img src="https://img.shields.io/github/v/release/onescience-ai/onecode-app?style=flat&logo=github" alt="GitHub release">
  </a>
</p>

<p align="center">Claude Code、Codex、Copilot、OpenCode 和 Pi agents 的统一界面。</p>

<p align="center">
  <img src="https://onescience.ai/hero-mockup.png" alt="OneCode app screenshot" width="100%">
</p>

---

在你自己的机器上并行运行 agents。无论在手机上还是桌前，都能推进交付。

- **自托管：** Agents 在你的机器上运行，使用完整的本地开发环境、工具、配置和技能。
- **多提供商：** 通过同一个界面使用 Claude Code、Codex、Copilot、OpenCode 和 Pi。为每个任务选择合适的模型。
- **语音控制：** 在语音模式下口述任务或讨论问题。需要免手操作时很方便。
- **跨设备：** 支持 iOS、Android、桌面端、Web 和 CLI。在桌前开始工作，用手机查看进度，也可以从终端脚本化操作。
- **隐私优先：** OneCode 没有遥测、追踪，也不会强制登录。

## 快速开始

OneCode 会运行一个名为 daemon 的本地服务，用来管理你的 coding agents。桌面 app、移动 app、Web app 和 CLI 等客户端都会连接到它。

### 前置条件

你至少需要安装一个 agent CLI，并用你的凭据完成配置：

- [Claude Code](https://docs.anthropic.com/en/docs/claude-code)
- [Codex](https://github.com/openai/codex)
- [GitHub Copilot](https://github.com/features/copilot/cli/)
- [OpenCode](https://github.com/anomalyco/opencode)
- [Pi](https://pi.dev)

### 桌面 app（推荐）

从 [onescience.ai](https://onescience.ai) 或 [Gitee releases 页面](https://gitee.com/onescience-ai/onecode-app/releases)下载。打开 app 后 daemon 会自动启动，不需要再安装其他东西。

如果要从手机连接，在 Settings 中扫描显示的二维码。

### CLI / 无头模式

安装 CLI 并启动 OneCode：

```bash
npm install -g @onescience/cli
onecode
```

终端中会显示一个二维码。你可以从任意客户端连接。这个方式适合服务器和远程机器。

### Docker

在 Docker 中运行 OneCode daemon 和自托管的 Web UI：

```bash
docker run -d --name onecode \
  -p 6767:6767 \
  -e ONECODE_PASSWORD=change-me \
  -v "$PWD/onecode-home:/home/onecode" \
  -v "$PWD:/workspace" \
  ghcr.io/onescience-ai/onecode:latest
```

启动后打开 `http://localhost:6767`。使用你需要的 agent CLIs 扩展基础镜像，然后通过环境变量或持久化的 `/home/onecode` 卷提供凭据。完整安装细节见 [Docker 文档](docs/docker.md)。

## CLI

你能在 app 中完成的事情，也都可以在终端中完成。

```bash
onecode run --provider claude/opus-4.6 "implement user authentication"
onecode run --provider codex/gpt-5.4 --worktree feature-x "implement feature X"

onecode ls                           # 列出正在运行的 agents
onecode attach abc123                # 实时流式查看输出
onecode send abc123 "also add tests" # 发送后续任务

# 在远程 daemon 上运行
onecode --host workstation.local:6767 run "run the full test suite"
```

## 开发

Monorepo 包结构速览：

- `packages/server`：OneCode daemon（agent 进程编排、WebSocket API、MCP server）
- `packages/app`：Expo 客户端（iOS、Android、Web）
- `packages/cli`：用于 daemon 和 agent 工作流的 CLI
- `packages/desktop`：Electron 桌面 app
- `packages/relay`：用于远程连接的 relay 包

常用命令：

```bash
# 运行所有本地开发服务
npm run dev

# 单独运行某个界面
npm run dev:server
npm run dev:app
npm run dev:desktop

# 构建 server stack
npm run build:server

# 全仓库检查
npm run typecheck
```

---

<p align="center">
  <a href="https://star-history.com/#onescience-ai/onecode-app&Date">
    <picture>
      <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=onescience-ai/onecode-app&type=Date&theme=dark">
      <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=onescience-ai/onecode-app&type=Date">
      <img src="https://api.star-history.com/svg?repos=onescience-ai/onecode-app&type=Date" alt="Star history chart for onescience-ai/onecode-app" width="600" style="max-width: 100%;">
    </picture>
  </a>
</p>

## License

AGPL-3.0