pandacode README

README проекта с github.com/aicodeking/pandacode. Одним файлом markdown: README.md.

PandaCode

A small, native desktop workspace for coding agents. PandaCode runs the coding CLIs you already use — Claude Code, Codex, Kimi Code, OpenCode, GLM Coding Plan, Xiaomi MiMo and Alibaba Token Plan (through Claude Code), GitHub Copilot CLI, Antigravity, xAI's Grok Build, DeepSeek, Command Code, Cline, Kilo Code, Devin CLI, Hermes Agent and Cursor CLI (through ACP), ZCode (through its app-server protocol), Pi and its fork omp (through Pi's RPC mode), and Meta's Muse Code (through its MSP protocol) — side by side, with your projects, Git, a terminal and a browser in one window.

PandaCode is free and open source under the PandaCode License, the MIT License with one addition: forks that are used commercially or released publicly must say "This is a fork of PandaCode" and link to this repository. There is no account, no license key and no telemetry.

Built with Tauri 2, Rust, SQLite and plain TypeScript. It uses the operating system's webview: no bundled Chromium, resident Node server, React runtime or embedded editor engine.

Download: macOS (Apple silicon) · macOS (Intel) · Windows x64 · Windows arm64 · Linux x64 · Linux arm64 · All releases · iPhone (TestFlight)

PandaCode with a finished Claude Code task as one turn card over a dusk alpine scene, with the task sidebar, the prompt box and the Changes inspector

Features

The interface

Agents

Review and build

Run it anywhere

Screenshots

One card per turn. The running step and elapsed time on top, the latest reply inside, and the changed files in the footer.

A finished turn card: a summary of its steps, 2m 14s elapsed, a shortened reply with Read more, and a footer with 3 changed files

Up to six threads at once. Tile threads inside the thread area, each with its own scene. The focused tile is the full thread and the others update live.

Four threads tiled in a grid, each with its own scene, with the prompt box in the focused tile

Light or dark, with a scene that follows the clock.

The light theme with a daytime ocean scene behind a finished turn card, the task sidebar and the Changes inspector
A live turn card with a reply still streaming and a running timer, over an aurora scene beside the action dock
Live replies. Responses stream in as Markdown, under the step the agent is on.
The searchable model picker with harnesses on the left, Claude Code's models with context sizes, and an effort control
Any harness, any model. Switch per task, with context size and reasoning effort.

Agent teams. An architect plans the work, runs workers in parallel across harnesses, and reviews what they bring back. The dock's Agents item shows every worker.

A finished team run with the architect's summary and changed files, and the Agents flyout listing two workers ready for review

A board for everything in flight. Tasks from every project move from Pending to Settled, each with its harness and linked issue.

The task board with Pending, In progress, Review and Settled columns

GitHub in one view. Your repositories with their threads, pull requests, issues and actions, including review and CI status.

The GitHub view with repositories on the left and a repository's pull requests with review and CI status

Your app beside the chat. The iOS Simulator and Android emulator run in the inspector on a lifelike device, so you can tap through what an agent just built. On Windows and Linux the tab lists Android emulators only.

The inspector showing an iPhone 17 Pro simulator next to the conversation

Bots that keep working. A bot's conversation is an ordinary task thread, with the same streaming, composer and model picker; reach it from Telegram, Slack, Discord, WhatsApp or a browser too.

A bot named Scout replying with a morning digest over an aurora scene
The changed-files viewer with a syntax-highlighted unified diff
Review every turn. Each turn saves its changes, with unified and split diffs.
A bot's settings on the Connections tab, with cards for Web chat, Telegram, Slack, Discord and WhatsApp
Bot settings. Connections, schedules, memory and skills, in one place.

Settings in nine sections. Recommended, General, Appearance, Voice, Agents, Schedules, Tools, Connections and About, with colors and imported VS Code themes.

Settings on the Appearance page, with the nine sections listed on the left and theme, color and VS Code theme controls

Screenshots come from the browser preview with sample data. Regenerate them with npm run screenshots (see scripts/screenshots).

Voice dictation inserts a draft without sending it. Transcribe on your computer with a speech model you download in Settings → Voice, or send audio to a speech service you configure; see voice input.

Privacy

A few automatic checks send no personal data — just plain requests for public information:

What Where How often
Latest versions of installed coding CLIs formulae.brew.sh, downloads.claude.ai, api.github.com, cdn.kimi.com, registry.npmjs.org, releases.openai.com, storage.googleapis.com, pypi.org About every 6 hours
Plan usage checks for your signed-in agents That agent's provider When you open the menu bar item or the Usage dialog, and in Settings → Providers when account pools are shown (once, then at most every 5 minutes on window focus, or when you click Refresh)
Asking your Claude Code for usage when PandaCode can't read it (on by default; Settings → Providers → Claude Code → Let PandaCode ask Claude Code for usage when it can’t read it): PandaCode runs your installed Claude Code once, claude -p /usage (a local command: no model call, nothing billed), with only its config folder, network and process settings (its telemetry, error reports, nonessential traffic and self-update turned off for this run), which lets Claude Code refresh and save its own login if it needs to, as when you open it (it may answer from its own snapshot instead). PandaCode never writes Claude Code's credentials Whatever Claude Code itself contacts to refresh its login and read usage (Anthropic) Only during a Claude usage check that can't read usage (an expired, rejected or missing login, a Keychain or network problem, a rate limit with no saved reading; never for an API-key or other non-subscription setup, a locked Keychain or a Keychain read you denied unless you press Refresh), at most once per Claude setup every 15 minutes (a Refresh you press may run it once more), less often while runs keep failing (up to every 2 hours), never two at once, and never inside a rate limit's server-set wait (after it, a new rate limit with no or an old saved reading may run it); never while the setting is off
Warm start of a coding agent: the CLI of a harness you installed and picked is launched in the background as a normal launch would, including your own startup hooks, plugins and configured MCP servers, which may contact their hosts; no prompt is sent (for Codex, the task's saved conversation may be loaded ahead, but no turn is sent). Turn off with Settings → Agents → Start agents ahead That agent's provider, and whatever your hooks, plugins and MCP servers contact After a turn ends, when you pick a task's model, effort, permissions or harness in its main thread, and when you start typing in a local task's message box (not a bot's thread); at most 2 idle at a time, each stopped after 10 minutes
Public model price list (for cost estimates) raw.githubusercontent.com Daily
PandaCode's own updates (latest.json on this repository's latest release) github.com At launch and about every 6 hours unless Settings → About → Updates is Off
Jev decision model list (optional) openrouter.ai Only when you choose OpenRouter for Jev decisions and open the model menu or press Refresh; no key is sent
Jev decisions on OpenRouter (optional) openrouter.ai Only when you choose OpenRouter in Settings → Tools → Add-ons → Jev and run a decision check; sends the selected evidence with your key
Jev decisions on TypeSafe (optional, the default service): sends the selected evidence with your key TypeSafe Only when you save a TypeSafe key in Jev's setup and run a decision check
Cloud agents (optional): the task's checkout, prompt and harness login go to the machine you chose; PandaCode checks on its active runs The cloud provider you connected Only for tasks you start on a cloud provider; while a run is active and at launch to re-attach
Model routing profiler (optional): model.int8.onnx and tokenizer.json, from a pinned commit, verified by SHA-256 raw.githubusercontent.com Once, the first time you turn on a team (with routing on) or click Download or Route in Settings → Agents → Model routing; never at launch, and never on macOS older than 13.4 or on Intel Mac, x86_64 Linux and x86_64 Windows builds
PandaCode Connect (optional): GitHub sign-in, then the relay that forwards your devices' end-to-end encrypted messages github.com, the PandaCode relay Only after you sign in under Settings → Connections → Remote access; nothing before
Push notifications (optional, mobile app): the relay sends a generic alert ("A task finished") with a pandacode://inbox link to your phone's device token, never task content Apple Push Notification service, Firebase Cloud Messaging (sent by the PandaCode relay) Only after you allow notifications in the mobile app while signed in to Connect
Voice input with a speech service (optional): recorded audio, selected model and optional language, authenticated with your speech key The transcription endpoint you configure (OpenAI, Groq, Mistral or your local/custom server) Only with that service chosen, when you stop or transcribe a recording (Stop, Enter, Transcribe recording, Retry) or when switching threads or anything else closes the prompt box mid-recording while PandaCode keeps running; automatic stops (the two-minute or 16 MiB limit, or a failing microphone) keep the audio until you press Transcribe recording; with This device, audio never leaves your computer
Local speech models (optional): the model file you pick and, with the first one, the Silero voice-activity model (about 1 MB), from a pinned revision, verified by SHA-256 huggingface.co, *.huggingface.co and the download CDN *.hf.co Only when you click Download in Settings → Voice; nothing at launch, while browsing models or while dictating
Netlify token check (optional): verifies the token and project you enter api.netlify.com Only when you save a Netlify token in Settings → Connections → Cloud sandboxes
Adding skills (optional): npx fetches the skills CLI from the npm registry set in your ~/.npmrc, which reads the source you choose: a GitHub or GitLab repository, or a local folder (telemetry off) registry.npmjs.org (or your configured registry), github.com or gitlab.com Only when you click Find skills, choose a folder or click Install in Settings → Tools → Skills; listing and switching skills are local

Install

Download the latest build from GitHub Releases:

Platform File Requirements
macOS (Apple silicon) PandaCode-macOS-arm64.dmg macOS 12+
macOS (Intel) PandaCode-macOS-x64.dmg macOS 12+
Windows x64 PandaCode-Windows-x64-setup.exe Windows 10 1809+ or Windows 11
Windows arm64 PandaCode-Windows-arm64-setup.exe Windows 11 on ARM (Snapdragon X and similar)
Linux x64 PandaCode-Linux-x86_64.AppImage Ubuntu 22.04+ or compatible, X11 or XWayland
Linux arm64 PandaCode-Linux-aarch64.AppImage Ubuntu 24.04+ aarch64 or compatible, X11 or XWayland

Or from a terminal: npx pandacode downloads the latest build, verifies its update signature and installs it (on macOS it also signs the installed app locally). npx pandacode --dry-run only downloads and verifies.

With Homebrew: brew install --cask aicodeking/pandacode/pandacode on macOS, or brew install aicodeking/pandacode/pandacode on Linux (details).

The official macOS builds are Developer ID signed and notarized by Apple (verified for v0.3.103). macOS may still ask you to confirm opening a downloaded app. Signing remains optional for local and fork builds, whose ad-hoc builds need the instructions there. Windows and Linux builds are not code-signed:

Each file has a .sha256 checksum beside it. Once installed, PandaCode updates itself: it checks the latest release, downloads a newer version in the background, verifies its signature, and restarts to install it when no agent is working and you've stepped away (or when you click Restart to update). In Settings → About, Notify me checks but asks first (Install and restart / Later), and Off stops checking. On Linux only the AppImage updates itself; an unpacked AppImage or a package just reports new versions. See platform support for details.

Then install Git and at least one coding CLI and sign in with its normal login. PandaCode does not include provider plans or usage.

Pi installs with npm i -g @earendil-works/pi-coding-agent; sign in through Pi's own CLI. PandaCode drives it over Pi's RPC mode and gives it PandaCode's app tools through a local loopback bridge extension. Pi has no approval system of its own, so PandaCode's extension enforces the permission modes; the integrated console needs Full access.

omp (Oh My Pi), a Pi fork that runs on Bun, installs with bun install -g @oh-my-pi/pi-coding-agent; sign in through omp itself. PandaCode drives it with the same RPC bridge as Pi and passes --approval-mode yolo so the bridge stays the only approval gate.

DeepSeek installs with npm i -g @deepseek-ai/dsh; PandaCode launches dsh --profile acp. An API key is optional (Settings → Agents → Providers, or DEEPSEEK_API_KEY); dsh can use its own stored credentials. With a saved key (or DEEPSEEK_API_KEY), the Usage dialog shows the account balance from api.deepseek.com.

Command Code installs with npm i -g command-code (Node 22 or newer); PandaCode launches command-code acp. Sign in once with command-code login, or save an API key in Settings → Agents → Providers (or set COMMAND_CODE_API_KEY); either one authenticates the same account. Usage limits are not shown in PandaCode; check Command Code Studio. Cline installs with npm i -g cline; PandaCode launches cline --acp. Sign in once with cline auth (or set CLINE_API_KEY); the provider and models chosen in Cline apply. See provider details.

Kilo Code installs with npm i -g @kilocode/cli; sign in with kilo auth login, then select Kilo Code in PandaCode. PandaCode launches kilo acp and uses Kilo's configured providers and models. See provider details.

Muse Code installs with Meta's launcher into ~/.local/bin/muse; run muse login once in a terminal. PandaCode launches muse serve and speaks MSP, Muse's JSON-RPC session protocol, with its sandbox and approval modes; see docs/providers.md for what each mode does and what Muse cannot express.

Antigravity runs Google's agy_acp_server, or agy acp --process-per-session through the agy CLI when that server isn't installed. See provider details.

GitHub Copilot CLI installs with npm install -g @github/copilot; run copilot login in a terminal, then select GitHub Copilot CLI in PandaCode. PandaCode launches the local copilot executable over ACP. The CLI manages its own sign-in. See provider details.

Devin CLI installs with curl -fsSL https://cli.devin.ai/install.sh | bash (or brew install --cask devin-cli, or the copy bundled with Devin Desktop); run devin auth login once in a terminal, then select Devin CLI in PandaCode. PandaCode launches devin acp with the CLI's own sign-in and lists every Devin model with its own thinking levels. See provider details.

ZCode installs with its install script (~/.local/bin/zcode, Node 24); run zcode once in a terminal and sign in, then select ZCode in PandaCode. PandaCode talks to zcode app-server directly — the CLI's own protocol, since it exposes no ACP mode — listing every model the account can reach with its own reasoning levels. See provider details.

Hermes Agent installs with curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash; run hermes acp --setup or configure ~/.hermes/config.yaml, then select Hermes Agent in PandaCode. PandaCode launches hermes acp and uses Hermes' configured provider and models. See provider details.

Cursor CLI installs with curl https://cursor.com/install -fsS | bash; run agent login once in a terminal (or set CURSOR_API_KEY), then select Cursor CLI in PandaCode. PandaCode launches agent acp with the CLI's own sign-in and lists the models on your Cursor plan, each with its own thinking levels. See provider details.

Build from source

You need Node.js 22, stable Rust, and the Tauri prerequisites for your OS.

git clone https://github.com/aicodeking/pandacode.git
cd pandacode
npm ci
npm run desktop        # same as: npm run tauri dev

npm run dev serves only the frontend. In a regular browser it runs a labeled, device-local sample workspace for UI work; files, Git and terminals are simulated there. npm run tauri build makes a local installer, and npm run release:build builds the release asset for your OS (see releasing).

The website lives in website/: npm run site:dev and npm run site:build.

Use

Open a project folder, then click New task or press ⌘/Ctrl N. A centered "What should we build in …?" page opens in the last active project with the message box focused. Choose the harness and model from the searchable picker in the message box; new tasks remember your last choice. The + button attaches images, documents, folders, project files or a mockup. Open Changes to inspect and stage diffs, or the terminal to run shell commands. Conversations and provider session IDs persist across restarts; agents start only for active turns.

In Files, an HTML file opens in the Browser panel; other files, including images, PDFs, Word documents and spreadsheets, open in a file tab beside the conversation. Filenames mentioned in responses become clickable and resolve against the task's own project or worktree.

The row at the bottom of the prompt box holds the model, permissions, Team, token saver, checkout and branch. Its branch chip is the one place for worktrees: an unstarted task moves into a new worktree in place, a started one spawns a sibling task, and settling a clean worktree task offers to remove its checkout and merged branch.

Pick Board from the view menu beside the PandaCode name to manage tasks by status. Choose Team in the composer for an automatic team, or set up an architect and workers. Each agent turn is one card, with its tool calls behind the header; approval requests wait in the bar above the prompt.

On macOS and Windows, closing the window hides it and running agents keep going; the menu bar item, the Dock or launching the app again brings it back. On Linux, closing the window quits PandaCode.

The branch chip also switches the project checkout to main or another local branch, and in a worktree task offers Merge into main: it merges the worktree's committed work locally, refuses uncommitted changes or conflicts without touching anything, then offers to remove the worktree.

Standard permissions keep each provider's native checks. Claude's Accept edits allows its editing tools; Codex uses its workspace sandbox with on-request approvals. Full access enables the harness's broadest mode. See provider details.

Type / at the start of a message for the harness's commands and skills (slash commands).

Keyboard shortcuts: ⌘/Ctrl N new task, ⌘/Ctrl K command palette, ⌘/Ctrl J terminal, ⌘/Ctrl B sidebar, ⌘/Ctrl , settings, ⌘/Ctrl F find in thread (⌘/Ctrl G next match), Enter send (queues while an agent runs), ⌘/Ctrl Enter steer, Shift Enter newline, ⌘⌥←/→ move between tiled threads, ⌘/Ctrl +/−/0 interface size (the whole interface scales, not just text).

On macOS, if folder access is denied, use Browse to select the folder, or allow PandaCode under System Settings → Privacy & Security → Files & Folders.

The thread shows one of eight live scenes that follows the time of day, and each thread keeps its own. PandaCode also includes 21 anime scenery wallpapers, a different morning, afternoon and night scene for each weekday: turn them on in Settings → Appearance → Wallpapers. You can also import VS Code color themes.

The optional Jev add-on adds work review, project-rule checks and app testing in isolated Chrome profiles. It is off by default and PandaCode works fully without it.

Resource limits

No background directory polling or recursive file watchers. Agents exit after each turn and resume by provider session ID; a run stays open only while background subagents finish or a Codex goal is active. After a Claude Code turn, the next turn's process starts in the background so a follow-up skips the CLI's startup; at most two wait at a time, each for up to 10 minutes. PandaCode's fixed instructions go to Claude-family harnesses once as a cached system prompt rather than in every message. Motion is short and subtle, and the system's reduced-motion setting turns it off; a thread you return to draws from its saved page at once. Terminal and Markdown code load only when needed. Terminal history, provider frames, files, diffs and streamed text all have explicit limits; only the current 100-message page of a conversation is loaded. Resource usage reports native core RSS, active agents, terminals and database size (core RSS excludes the system webview and provider processes).

Tests

npx tsc --noEmit           # typecheck
npm run build && npm test  # unit tests (some read dist/)
npm run test:release       # release script tests
npm run test:rust          # cargo test
npx playwright test        # browser suite (Chrome)
npx playwright test -c playwright.webkit.config.ts   # WebKit

Ordinary tests make no paid model calls. Opt-in live tests are #[ignore]d; see providers.

Contributing

Contributions are welcome. Read CONTRIBUTING.md for setup and the pull request process, and AGENTS.md for code conventions. Please follow the Code of Conduct, and report security issues privately as described in SECURITY.md. Bugs and ideas go in GitHub issues.

Architecture notes: design, native IPC, research. Provider protocols live in src-tauri/src/providers.rs behind one normalized event interface; ACP harnesses share acp.rs.

Data

Data lives in Tauri's per-user application data directory (on macOS, ~/Library/Application Support/ai.pandacode.desktop/) in kingcode.sqlite3; the database keeps its legacy internal name. Project source stays in the folders you open, and removing a project from the app never deletes its files.

License

PandaCode License (MIT with an attribution requirement for forks) © 2026 PandaCode contributors. Provider names and logos belong to their owners and do not imply endorsement (brand assets). Bundled third-party components and their licenses are listed in THIRD_PARTY_NOTICES.md. A copy ships inside the app, and Settings → About → Third-party notices opens it.

pandacode (aicodeking/pandacode)

Ищем в базе…

Что это?PandaCode — небольшое нативное настольное рабочее пространство, которое запускает CLI-инструменты для написания кода, уже знакомые вам: Claude Code, Codex, Kimi Code, OpenCode, DeepSeek, GitHub Copilot CLI и другие. Они работают рядом с вашими проектами, Git, терминалом и браузером в одном окне.
PandaCode сам является агентом для написания кода или это просто оболочка для других агентов?Это оболочка рабочего пространства, а не собственный агент. Она запускает и управляет уже установленными у вас CLI-обвязками (Claude Code, Codex, DeepSeek, Cline, Pi и др.) и предоставляет им общий интерфейс с задачами, Git и браузером.
Нужно ли мне устанавливать CLI для написания кода отдельно?Да, PandaCode только управляет ими. Нужны Git и хотя бы один CLI для написания кода (Claude Code, Codex, dsh от DeepSeek, Cline, Pi и др.), установленный и авторизованный через собственный вход. PandaCode не включает тарифные планы провайдеров и не учитывает их использование.
Подписаны ли релизные сборки кодом?Нет, релизные сборки не подписаны кодом. Поэтому macOS, Windows SmartScreen и Linux при первом запуске покажут предупреждение, которое нужно подтвердить вручную, прежде чем приложение откроется.
Какие данные отправляет PandaCode?Ни ваш код, ни запросы не отправляются в сам PandaCode. Проекты и диалоги хранятся в локальной базе SQLite, а запросы уходят только к выбранному вами CLI или сервису и обрабатываются на условиях этого провайдера.
В чём подвох с лицензией PandaCode?Это лицензия MIT плюс одно условие: если вы форкнете PandaCode и будете использовать форк в коммерческих целях или публиковать его открыто, нужно указать, что это форк PandaCode, и дать ссылку на этот репозиторий.
Что такое команды агентов?Агент-архитектор планирует работу и запускает до трёх агентов-исполнителей. Они могут использовать разные обвязки и модели или именованный профиль команды. Каждый исполнитель отображается одной строкой в диалоге, который его запустил, а клик по строке открывает его собственное представление.
Может ли агент продолжать работу, пока мой ноутбук закрыт?Да. Если в меню «Run on» задачи выбрать облачного провайдера (Daytona, Cloudflare, AWS, Google Cloud, E2B, Modal, Vercel Sandbox и другие), агент будет работать на машине в вашем аккаунте. Он продолжит работу, пока ноутбук спит, и вернёт изменения в локальный worktree.
Можно ли превратить агента в чат-бота?Да. Агента можно подключить к Telegram, Slack, Discord, WhatsApp или локальному веб-чату. Каждый диалог с ботом — это обычная задача с той же потоковой выдачей, полем ввода и выбором модели.
Что делает функция Token saver?Она применяет для каждой задачи наборы стилей ответов, которые сокращают объём текста, возвращаемого агентом, и тем самым уменьшают расход выходных токенов.
Какие есть похожие проекты?atlas, skills-manager, opcode, desktop-cc-gui, hyperfide-oss, CodexMonitor, OpenResearch, emdash
В каких он темах?tauri, github, git, deepseek, sqlite, multi-agent, desktop, coding-agent, rust, gui, codex, agent
Автор
aicodeking
Размер
116 MB
Звёзды
1.3K
Возраст
1 мес
Коммиты · 90 дней