[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-1307":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":13,"openIssues":13,"contributorsCount":14,"subscribersCount":14,"size":14,"stars1d":15,"stars7d":16,"stars30d":17,"stars90d":14,"forks30d":14,"starsTrendScore":18,"compositeScore":19,"rankGlobal":9,"rankLanguage":9,"license":20,"archived":21,"fork":21,"defaultBranch":22,"hasWiki":23,"hasPages":21,"topics":24,"createdAt":9,"pushedAt":9,"updatedAt":25,"readmeContent":26,"aiSummary":27,"trendingCount":14,"starSnapshotCount":14,"syncStatus":28,"lastSyncTime":29,"discoverSource":30},1307,"Clarc","ttnear\u002FClarc","ttnear","Native macOS client for Claude Code — a GUI desktop app built with SwiftUI",null,"Swift",287,29,1,0,6,9,19,18,4.43,"Other",false,"main",true,[],"2026-06-12 02:00:26","# Clarc\n\n**The terminal was for the few. Clarc is for everyone.**\n\nClarc is a lightweight native macOS desktop client for Claude Code. It brings the CLI agent workflow into a project-centric GUI with streaming chat, repository switching, file browsing, Git status, permissions, terminal access, and per-project notes.\n\n![Platform](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fplatform-macOS%2015.0%2B-blue)\n![Swift](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FSwift-6.x-orange)\n![Version](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fversion-1.2.0-blue)\n![License](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-Apache%202.0-green)\n\n---\n\n## Screenshots\n\n![Clarc Screenshot](docs\u002Fscreenshot.png)\n\n---\n\n## Why Clarc?\n\nThe terminal is a wall. For most people who aren't developers, it's a closed door — install a CLI, generate SSH keys, approve every tool call without a real preview of what it's about to do. None of that is hard for engineers; all of it is hard for everyone else. The terminal was for the few, and it still is.\n\nClarc was built so my non-developer coworkers could use Claude Code without learning a shell first. It doesn't reinvent the agent. It spawns the real `claude` CLI underneath, so your `CLAUDE.md`, skills, MCP servers, and slash commands keep working as-is. What sits on top is a native Mac app:\n\n- Approval modals that surface the actual diff before any tool runs, with risk-aware Allow \u002F Allow Session \u002F Deny options.\n- Per-project windows you can run in parallel — switch tabs, double-click to spin off a window, keep streams alive in the background.\n- Drag-and-drop attachments, smart paste for images, file paths, URLs, and long text.\n- GitHub OAuth that handles SSH key setup for you, so `git clone` just works.\n- An inspector with a file tree, Git status, embedded terminal, and a per-project memo pad.\n\nSame engine, no terminal required.\n\n---\n\n## Key Features vs. Claude Desktop\n\n| Clarc feature | Why it matters |\n|---------------|----------------|\n| **Native macOS app** | Built with SwiftUI, not Electron. The current v1.2.0 release is about 5.6 MB to download and about 13 MB unpacked, without bundling a browser runtime. |\n| **Project-centric workspace** | Register multiple local repositories, switch between them from project tabs, or open a project in its own window for parallel sessions. In-progress streams keep running in the background while you switch. |\n| **Custom slash commands** | Add, edit, disable, import, and export custom slash commands. Built-in commands can be edited locally, while JSON import\u002Fexport stays custom-only. |\n| **Shortcut buttons** | Create quick buttons for prompts or terminal commands you run repeatedly. Terminal-command shortcuts can launch directly into Clarc's interactive terminal popup. |\n| **Built-in file explorer with Git status** | Browse and search project files, toggle hidden files, preview or edit files, inspect Git status, and switch branches from the sidebar. |\n| **Rich-text memo pad per project** | Keep project-specific notes in the inspector panel with headings, lists, checkboxes, links, and Markdown copy\u002Fpaste support. |\n| **Embedded terminal** | Use a SwiftTerm-based terminal in the inspector, plus interactive terminal popups for commands such as `\u002Fconfig`, `\u002Fpermissions`, and `\u002Fmodel`. |\n\n---\n\n## Features\n\n| Feature | Description |\n|---------|-------------|\n| **Streaming Chat** | Real-time Claude Code conversations with Markdown rendering, tool call visualization, diff views, and error bubbles for failed empty responses. |\n| **Multi-Project Workspace** | Register local folders or GitHub repositories, switch freely, and keep per-project session history. |\n| **Dedicated Project Windows** | Double-click a project tab to open it in an independent window and work across multiple repositories at once. |\n| **Per-Session Controls** | Choose model, permission mode, and effort level per session from the chat toolbar. Defaults are configurable in Settings. |\n| **Permission Modes** | Ask, Accept Edits, Plan, Auto, and Bypass modes mirror Claude Code's permission model and can be changed from the toolbar. |\n| **Permission Management** | Risk-based approve\u002Fdeny UI with Allow, Allow Session, Deny, and 5-minute auto-deny handling. |\n| **Effort Levels** | Auto, Low, Medium, High, XHigh, and Max reasoning controls for each session. |\n| **Model Selection** | Claude Code aliases with localized descriptions, including Opus, Sonnet, Haiku, 1M context, and plan variants. |\n| **File Attachments** | Drag-and-drop files and images. Smart paste detects images, file paths, URLs, and long text. |\n| **Attachment Auto-Preview Settings** | Toggle automatic preview chips separately for URLs, file paths, images, and long text. |\n| **Slash Commands** | Built-in and custom command system with built-in command edits\u002Ftoggles and custom-command JSON import\u002Fexport. |\n| **Shortcut Buttons** | Configurable quick-access buttons for frequent prompts and terminal commands. |\n| **Message Queue** | Queue messages while Claude is responding; cancel queued items with ESC or the remove button. |\n| **Status Line** | Project path, model, 5-hour and 7-day rate limits, context usage, and response time at a glance. |\n| **Built-in Terminal** | SwiftTerm-powered inspector terminal with reset support, plus full interactive terminal sheets. |\n| **File Explorer** | Project file tree with search, hidden-file toggle, syntax-highlighted preview, file editing, and `@path` insertion. |\n| **Git Status** | Sidebar Git status summary with changed-file counts, branch display, and local\u002Fremote branch switching. |\n| **GitHub Integration** | OAuth device flow, Keychain token storage, SSH key management, repository browsing, and cloning. |\n| **Memo Panel** | Per-project rich-text memo pad with headings, lists, checkboxes, links, and persistent storage. |\n| **Skill Marketplace** | Browse and install official Anthropic plugins, refreshed with a 5-minute cache. |\n| **Themes and Font Controls** | Six accent themes plus independent font size controls for the interface and message area. |\n| **Focus Mode** | Optional focused chat layout that can be enabled from Settings. |\n| **Notifications** | Optional system notifications with response previews while Clarc is in the background. |\n| **Localization** | Full English and Korean UI. |\n| **User Guide** | Built-in in-app help guide accessible from the toolbar and Settings. |\n| **Auto-update** | Sparkle-based update checking on launch, with manual checks from the app menu. |\n\n---\n\n## Requirements\n\n- **macOS 15.0** or later\n- **[Claude Code CLI](https:\u002F\u002Fdocs.anthropic.com\u002Fen\u002Fdocs\u002Fclaude-code)** installed and authenticated\n- **Xcode with Swift 6.2+ toolchain** for building the current source tree\n\n---\n\n## Installation\n\n1. Download the latest `Clarc-x.y.z.zip` from the [Releases](https:\u002F\u002Fgithub.com\u002Fttnear\u002FClarc\u002Freleases) page.\n2. Unzip and move `Clarc.app` to your `Applications` folder.\n3. Launch `Clarc.app`.\n\n### First Launch on macOS 15 (Sequoia)\n\nmacOS Sequoia blocks the first launch of any downloaded app, even notarized ones, and routes approval through System Settings instead of the old right-click -> Open flow.\n\nWhen you see **\"Apple could not verify 'Clarc.app' is free of malware...\"**:\n\n1. Click **Done** on the dialog.\n2. Open **System Settings -> Privacy & Security**.\n3. Scroll to the Security section and click **Open Anyway** next to `Clarc.app`.\n4. Confirm with your password or Touch ID.\n\nAfter this one-time approval, Clarc launches normally. The app is signed with a Developer ID certificate and notarized by Apple. This prompt is standard macOS behavior, not a security warning specific to Clarc.\n\n---\n\n## Build from Source\n\n```bash\nopen Clarc.xcodeproj\n```\n\nFor a CLI build:\n\n```bash\nxcodebuild -project Clarc.xcodeproj -scheme Clarc -configuration Debug build\n```\n\nFor tests:\n\n```bash\nxcodebuild test -project Clarc.xcodeproj -scheme Clarc -destination 'platform=macOS'\nswift test --package-path Packages\n```\n\nFor a signed release ZIP, use the release scripts under `scripts\u002F`.\n\n---\n\n## Project Structure\n\n| Path | Purpose |\n|------|---------|\n| `Clarc\u002F` | macOS app target: app entry point, views, services, resources, and integrations. |\n| `Packages\u002FSources\u002FClarcCore\u002F` | Shared models, theme, utilities, Git helpers, and pure core logic. |\n| `Packages\u002FSources\u002FClarcChatKit\u002F` | Reusable chat UI, message rendering, input bar, slash commands, shortcuts, diffs, and status line. |\n| `ClarcTests\u002F` | App-level XCTest coverage. |\n| `Packages\u002FTests\u002F` | Swift Testing coverage for core utilities. |\n| `release_notes\u002F` | Human-readable release notes used for publishing. |\n| `scripts\u002F` | Build, notarization, Sparkle signing, and release automation. |\n\n---\n\n## License\n\nApache License 2.0. See the [LICENSE](LICENSE) file for details.\n","Clarc 是一个为 Claude Code 设计的轻量级原生 macOS 桌面客户端，它通过提供图形用户界面来简化命令行工具的工作流程。该项目采用 Swift 语言及 SwiftUI 框架构建，支持多项目管理、代码库切换、文件浏览、Git 状态查看、权限控制以及终端访问等功能，并且每个项目都可以添加自定义笔记。Clarc 适合那些希望在不熟悉命令行的情况下也能高效使用 Claude Code 的非开发者用户或团队成员，同时也为专业开发者提供了更加直观便捷的操作体验。",2,"2026-06-11 02:42:57","CREATED_QUERY"]