AgentDock

A local-first desktop workspace for AI CLI configuration sync.

AgentDock helps you edit shared instructions once, then sync them to:

• ~/.codex/AGENTS.md
• ~/.gemini/GEMINI.md
• ~/.claude/CLAUDE.md

中文文档

---

Features

• Unified prompt editing: Edit one shared base prompt plus Codex/Gemini/Claude-specific prompts in a single UI.
• One-click sync: Save and apply only changed files to target agent config paths.
• Automatic backup lifecycle: Every sync creates backups you can inspect, restore, or delete.
• Workspace bootstrap: On first launch, AgentDock can bootstrap source files from existing agent configs.
• Local-first by design: Data stays on your machine.

---

Prerequisites

Requirement	Minimum
Node.js	18+
pnpm	9+
Rust toolchain	stable (rustc, cargo)
GitHub CLI (gh)	latest
Tauri prerequisites	Follow official guide

---

Quick Start

pnpm install
pnpm tauri dev

Frontend-only mode:

pnpm dev

---

Project Structure

agentdock/
├── src/
│   ├── api.ts
│   ├── types.ts
│   └── features/prompt-sync/
│       ├── components/      # Sidebar, editors, backup panel
│       ├── hooks/           # workspace/editor/backup hooks
│       └── utils/
├── src-tauri/
│   ├── src/
│   │   ├── lib.rs           # Tauri commands
│   │   ├── mapping.rs       # category mapping and normalization
│   │   ├── sync.rs          # sync planning and apply
│   │   ├── backup.rs        # backup list/detail/restore/delete
│   │   ├── workspace.rs     # workspace initialization/migration
│   │   └── paths.rs         # app path resolution
│   └── tauri.conf.json
├── package.json
└── README.md

---

Workspace Layout

Default workspace root:

• ~/.agentdock

Main files:

• source/ shared source categories (instructions, skills, plugins, commands, mcp)
• mapping.json sync mapping rules
• backups/ sync backups

---

Development Commands

# frontend dev server
pnpm dev

# production frontend build
pnpm build

# tauri desktop app
pnpm tauri dev

# interactive GitHub release
pnpm release:github

---

Release

Automated release command:

pnpm release:github

Release notes support multi-line input; press Ctrl-D to finish.

Before running:

gh auth login -h github.com

The command will prompt you for:

1. Version (defaults to current patch +1, press Enter to accept, e.g. 0.1.0 -> 0.1.1)
2. Release notes (multi-line, finish with Ctrl-D)

Then it will automatically:

1. Update version in package.json, src-tauri/Cargo.toml, and src-tauri/tauri.conf.json
2. Build macOS app bundle
3. Create release/AgentDock_<version>_aarch64.app.zip and SHA256 file
4. Commit (release: v<version>), create tag, and push to GitHub
5. Create GitHub Release and upload assets