PinkCode

KO | EN

gitlite — search

#cli #agent #automation #framework #open-source #http #codex #github #computer-vision #developer-tools

(★ 9)

Desktop GUI for Grok Build: multi-session task board, live timeline, workspace browser, permission management, and usage dashboard.

파일 탐색기

ZIP 다운로드

- pre-commit
- - ci.yml
  - fix-updater-json.yml
  - pages.yml
  - release.yml
- agent-contract.json
- - README.md
  - STATUS.md
- github-social-preview.png
- logo.png
- product.jpg
- rosepinedawn.md
- favicon-180.png
- favicon-192.png
- favicon-32.png
- favicon-512.png
- favicon.png
- logo-512.png
- logo.png
- check-rust.mjs
- generate-icons.mjs
- generate-release-notes.mjs
- rewrite-updater-json.mjs
- windows-setup.ps1
- .nojekyll
- index.html
- og.jpg
- styles.css
- - logo-512.png
  - logo-e4-final.jpg
  - logo-e4-master.jpg
  - logo-master.jpg
  - logo.png
- - DiffPanel.tsx
  - DiffSnippet.tsx
  - FilePathLink.tsx
  - FilePreview.tsx
  - FileTree.tsx
  - GitChanges.tsx
  - GitDiffHunkPanel.tsx
  - HistoryMenu.tsx
  - MacosTitlebarBrand.tsx
  - Markdown.tsx
  - NewTaskModal.tsx
  - PermissionGate.tsx
  - PermissionModal.tsx
  - PlanApprovalModal.tsx
  - PromptBar.tsx
  - PromptChipSelect.tsx
  - PromptQueue.tsx
  - SessionDetail.tsx
  - SessionList.tsx
  - ShellPanel.tsx
  - StatsBar.tsx
  - TimelinePanel.tsx
  - TimelineRow.tsx
  - TurnStatusBar.tsx
  - UpdateModal.tsx
  - UserQuestionModal.tsx
  - WindowsTitlebar.tsx
  - WorkspacePanel.tsx
- - lifecycleSettle.ts
  - liveTimeline.test.ts
  - liveTimeline.ts
  - timelineIdentity.ts
  - useAgentEvents.ts
  - useAppUpdate.ts
  - useAppVersion.ts
  - useDraggableDialog.ts
  - useKeyedSilentRefresh.ts
  - usePromptHistoryBrowse.ts
  - usePromptQueueController.ts
  - useSessionIndex.ts
  - useSessionModel.ts
  - useSessionPlanMode.ts
  - useSlashCommandCatalog.ts
  - useTimelineHistory.test.ts
  - useTimelineHistory.ts
  - useUsageMetrics.ts
  - useVirtualWindow.test.ts
  - useVirtualWindow.ts
- - agent.css
  - base.css
  - detail.css
  - macos-titlebar.css
  - overlays.css
  - status.css
  - tokens.css
  - turn-status.css
  - windows-titlebar.css
  - workspace.css
- - clipboard.ts
  - dayUsage.test.ts
  - dayUsage.ts
  - diffSnippet.test.ts
  - diffSnippet.ts
  - editDiff.test.ts
  - editDiff.ts
  - format.ts
  - format.turn.test.ts
  - gitDiffHunks.test.ts
  - gitDiffHunks.ts
  - lifecycleState.ts
  - localSlash.ts
  - managedChrome.test.ts
  - managedChrome.ts
  - managedStatus.ts
  - paths.ts
  - permissionPayload.ts
  - pickSelectedId.test.ts
  - pickSelectedId.ts
  - platform.ts
  - promptHistory.test.ts
  - promptHistory.ts
  - promptQueue.test.ts
  - promptQueue.ts
  - reasoningEffort.test.ts
  - reasoningEffort.ts
  - sessionEvents.test.ts
  - sessionEvents.ts
  - sessionMode.test.ts
  - sessionMode.ts
  - sessionModel.test.ts
  - sessionModel.ts
  - slashCommands.test.ts
  - slashCommands.ts
  - subagentTasks.test.ts
  - subagentTasks.ts
  - toolTitle.test.ts
  - toolTitle.ts
  - turnActivity.test.ts
  - turnActivity.ts
  - windowsTitlebar.test.ts
  - windowsTitlebar.ts
- api.test.ts
- api.ts
- App.css
- App.tsx
- contract.test.ts
- main.tsx
- types.ts
- vite-env.d.ts
- - default.json
- - 128x128.png
  - [email protected]
  - 32x32.png
  - 512x512.png
  - 64x64.png
  - app-icon-master-windows.png
  - app-icon-master.png
  - icon-source.png
  - icon.icns
  - icon.ico
  - icon.png
  - Square107x107Logo.png
  - Square142x142Logo.png
  - Square150x150Logo.png
  - Square284x284Logo.png
  - Square30x30Logo.png
  - Square310x310Logo.png
  - Square44x44Logo.png
  - Square71x71Logo.png
  - Square89x89Logo.png
  - StoreLogo.png
- - agent_fs.rs
  - agent_manager.rs
  - agent_runtime.rs
  - agent_types.rs
  - ask_user_question.rs
  - auth.rs
  - billing.rs
  - cli.rs
  - config.rs
  - fs_atomic.rs
  - json_util.rs
  - lib.rs
  - main.rs
  - models.rs
  - permission_policy.rs
  - plan_approval.rs
  - plan_file_policy.rs
  - project_fs.rs
  - proxy.rs
  - rpc_handler.rs
  - session_noise.rs
  - session_usage.rs
  - sessions.rs
  - shell_emitter.rs
  - shell_stream.rs
  - skill_catalog.rs
  - task_prefs.rs
  - watcher.rs
  - windows_icons.rs
- .gitignore
- build.rs
- Cargo.lock
- Cargo.toml
- Info.plist
- tauri.conf.json
.gitignore
.nvmrc
index.html
LICENSE
package-lock.json
package.json
README.md
tsconfig.json
tsconfig.node.json
vite.config.ts

# CDN으로 사용하기

jsDelivr

jsDelivr는 공개 GitHub 리포지토리를 별도 설정 없이 CDN으로 즉시 서빙합니다. 버전과 파일을 고르면 웹페이지에 바로 붙일 수 있는 링크와 예시 코드가 만들어집니다.

버전

파일

링크

예시

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<img src="docs/logo.png" alt="PinkCode" width="128" />

<h1 align="center">PinkCode - Grok Desktop GUI</h1>

Effortless Parallel Tasks & Crystal-Clear Usage Visuals.

<a href="#screenshot">Screenshot</a>
 ·
 <a href="#features">Features</a>
 ·
 <a href="#installation">Installation</a>
 ·
 <a href="#development">Development</a>
 ·
 <a href="#architecture">Architecture</a>

Run multiple [Grok Build](https://x.ai/cli) tasks side by side, follow every task in a readable live timeline, and see where your credits and tokens go. PinkCode turns Grok Build's CLI workflow into a visual desktop workspace while keeping `grok` itself in charge: it connects over [ACP](https://spec.acp.dev) (Agent Client Protocol) via stdio and does not run a separate agent loop.

**Tauri 2 · React 19 · TypeScript · Rust**

## Screenshot

## Features

PinkCode is centered on two things that are difficult to manage from a terminal alone: keeping several agent tasks moving at once and understanding their activity and cost at a glance.

| Focus | What PinkCode makes easier |
|------|----------|
| **Parallel tasks** | Work across multiple Grok Build sessions from one task board. Create, switch, prompt, and stop tasks independently; each task connects to `grok` over ACP when you first send a message. Existing sessions are loaded from `~/.grok` (`%USERPROFILE%\.grok` on Windows). |
| **Clear task activity** | Read user messages, agent responses, thoughts, tool calls, shell output, plans, and events in one live timeline. Subagent and background-task cards update live; attach/reconnect refills running work via ACP list APIs. Reconnect restores history from `updates.jsonl`. |
| **Usage visuals** | See weekly Grok credit usage with a per-product breakdown, a 7-day token-usage series from session logs, and live turn tokens/cost while a turn is running. |

The rest of the interface keeps those parallel workflows practical:

| Area | Behavior |
|------|----------|
| **File changes** | Review agent file hunks from `hunk_records.jsonl`. |
| **Workspace & Git** | Browse the project tree, preview text and images, and manage Git: branch status (ahead/behind), staged/unstaged lists, inline file diffs, **per-hunk stage/unstage**, and commit. |
| **Modes & plans** | Shift+Tab-style cycle aligned with Grok Build: **Normal → Plan → Auto → Always-approve**. Plan is orthogonal to permission mode; free-text send becomes `/plan …`. When the agent exits plan mode, review and choose Approve, Request changes, or Quit. |
| **Model** | Switch the session model mid-task over ACP `session/set_model`. |
| **Permissions** | Default (ask), Accept edits, Auto (classified by Grok), Bypass permissions, Don't ask. Per-task prefs in `~/.pinkcode/task_prefs.json`. Handles tool permission, file writes, plan approval, and ask-user questions; the task list surfaces **Needs input** when a reverse-request is open. |
| **Updates** | Check GitHub Releases automatically on startup and optionally install an update in one click. |

## Installation

### 1. Install Grok Build

PinkCode requires the [Grok Build CLI](https://x.ai/cli).

**Windows (PowerShell):**

```powershell
irm https://x.ai/cli/install.ps1 | iex
```

**macOS / Linux / WSL:**

```bash
curl -fsSL https://x.ai/cli/install.sh | bash
```

By default, Grok stores its data under `~/.grok` on macOS/Linux and
`%USERPROFILE%\.grok` on Windows. Set `GROK_HOME` to use another location.

### 2. Install PinkCode

Download a prebuilt installer from **[GitHub Releases](https://github.com/3xian/PinkCode/releases)**:

- Windows x64: NSIS installer
- macOS: Apple Silicon and Intel builds
- Linux: build from source; CI installers are not available yet

On some Wayland compositors (niri, Sway, Hyprland, …) Overlay CSD and
acrylic transparency mis-render with WebKitGTK. These flags are a
workaround until that stack handles the default chrome; they can be
dropped then. Launch with:

```bash
PinkCode --disable-csd --disable-transparency
```

## Development

### Prerequisites

| | macOS | Windows 11 | Linux |
|---|---|---|---|
| Node | 24+ | 24+ | 24+ |
| Rust | stable | stable (`x86_64-pc-windows-msvc`) | stable |
| Platform | Xcode CLT | MSVC Build Tools + [WebView2](https://developer.microsoft.com/microsoft-edge/webview2/) | webkit2gtk ([Tauri prerequisites](https://v2.tauri.app/start/prerequisites/)) |
| Grok Build | installed | installed | installed |

Windows toolchain (once):

```powershell
winget install Microsoft.VisualStudio.2022.BuildTools --override "--wait --passive --norestart --add Microsoft.VisualStudio.Workload.VCTools --includeRecommended"
```

```powershell
powershell -ExecutionPolicy Bypass -File scripts/windows-setup.ps1
```

### Build and run

```bash
npm ci
npm run tauri:dev          # development
npm run tauri:build        # local installer under src-tauri/target/release/bundle/
npm run check              # frontend + Rust (fmt/clippy/test) — same as CI
```

**Env (optional)**

| Variable | Meaning |
|----------|---------|
| `GROK_BIN` | Path to `grok` / `grok.exe` |
| `GROK_HOME` | Grok data root (default `~/.grok`) |

**CLI (optional)**

| Flag | Meaning |
|------|---------|
| `--disable-csd` | Hide client-side decorations (black title bar on Wayland) |
| `--disable-transparency` | Opaque window (WebKitGTK + compositor alpha) |
| `-h`, `--help` | Show flags |

## Architecture

```
UI (React 19 + TypeScript)
 |-- invoke() --> Tauri commands
 | sessions, agent lifecycle, permissions,
 | billing, workspace FS, git status / hunk apply
 |-- listen() <-- Tauri events
 agent-* | sessions-changed
 |
 |-- AgentManager — N x `grok agent stdio` (ACP) + host permission gate
 |-- Session index — FS watcher on ~/.grok/sessions (cards, hunks, stats)
 |-- Billing — HTTP calls to Grok billing API (OIDC auth via ~/.grok/auth.json)
```

PinkCode communicates with Grok Build over ACP (JSON-RPC over stdio): prompts, `session/set_mode`, `session/set_model`, usage/recap extensions, and lifecycle notifications. The host-side permission gate intercepts reverse RPCs (`session/request_permission`, `fs/write_text_file`, `x.ai/exit_plan_mode`, `x.ai/ask_user_question`) and applies the configured risk policy before allowing or denying agent actions.

## License

Licensed under the [Apache License 2.0](LICENSE).

PinkCode

오너의 다른 레포

파일 탐색기

# CDN으로 사용하기

Was this content helpful?

Recent Feedback

PinkCode

오너의 다른 레포

파일 탐색기

# CDN으로 사용하기

Was this content helpful?

Recent Feedback

Download README