Craft Agents
github.com/lukilabs/craft-agents-oss- Category
- AI Agents
- Rank
- No. 806Tools index
Previous survey · No. 791 ·
- Pricing
- Open Source
- Type
- APP
- Builder
- lukilabs
- GitHub
- 7.2k stars
- Latest release
- v0.13.3
- Date
About
An open-source desktop client for running Claude agents in a document-centric interface instead of a terminal. Agents can be pointed at MCP servers, REST APIs and local files by asking in plain language rather than editing config, and sessions support file attachments, background tasks, custom workflows and per-session permission modes from read-only to auto-approve. Craft Docs built it for its own team and released it under Apache 2.0.
What it does
Craft Agents organizes agent conversations as persistent work items with inbox states, flags, background tasks, attachments, and change previews. Each workspace can use several model providers and connect agents to external services, local data, or MCP servers. Permission modes determine whether agents only explore, request approval, or act automatically.
Why it's ranked here
Its strongest case is operational depth. Sessions can persist locally or run on a remote server, while desktop and terminal clients share the same agent runtime. Multiple providers, source connections, approval controls, automations, and visible file diffs make it more than a chat shell. The setup surface is substantial, especially for remote deployment.
What's good
The session workflow treats agent work as a queue that can be flagged, archived, reviewed, and resumed. Source support covers MCP, REST APIs, and local files. Three permission levels provide a clear safety gradient. Long-running jobs expose progress, and the multi-file diff gives users a focused view of changes before accepting them.
Tradeoffs
Running from source requires Bun and an Electron build. Remote use adds bearer-token management, WebSocket configuration, and TLS or a terminating proxy for production exposure. The broad provider and integration surface also means credentials, local subprocesses, and workspace permissions require deliberate administration. Some shared internals still use direct source imports instead of stable package exports.
How to use it well
Use it when several agent sessions must stay organized, retain history, access workspace tools, and continue on a remote machine. Start with approval-required permissions, add only the sources each workspace needs, and inspect multi-file diffs before completion. It does not replace deployment infrastructure or remove the need to secure credentials and remote transport.
Technical notes+
The private Bun workspace is declared in package.json and spans packages/* plus apps/*. README.md documents Electron builds for macOS, Windows, and Linux, a Dockerized headless server, and a Bun-based CLI. packages/server/src/index.ts boots the authenticated WebSocket server, supports optional TLS and an embedded web UI, and wires shared RPC handlers. packages/pi-agent-server/src/index.ts isolates the Pi SDK in a child process using JSONL over stdio. packages/session-mcp-server/src/index.ts exposes session tools through MCP stdio and proxies documentation tools over streamable HTTP. packages/ui/src/index.ts exports React chat, markdown, terminal, diff, overlay, and viewer components. package.json defines Bun tests, Python document-tool smoke tests, type checking, linting, and CI validation scripts.
Observed
- License
- Apache-2.0
- Primary language
- TypeScript
- Packaging
- Private Bun monorepo with Electron desktop builds and Docker support for the headless server
- Install surface
- One-line installers for macOS, Linux, and Windows, plus source builds with Bun
- Interfaces
- Electron desktop app, Bun CLI, headless WebSocket server, web UI, and stdio MCP server
- Platform support
- Desktop distribution scripts target macOS, Windows, and Linux
- Agent runtimes
- Uses the Claude Agent SDK and Pi SDK side by side
- Validation structure
- Package scripts define Bun tests, Python document smoke tests, TypeScript checks, linting, and CI validation
Read from README.md, package.json, packages/ui/src/index.ts, packages/core/src/index.ts, packages/server/src/index.ts, packages/shared/src/index.ts, packages/server-core/src/index.ts, packages/pi-agent-server/src/index.ts, packages/messaging-gateway/src/index.ts, packages/session-mcp-server/src/index.ts, packages/session-tools-core/src/index.ts, packages/core/src/types/index.ts, packages/core/src/utils/index.ts, packages/shared/src/mcp/index.ts, packages/ui/src/context/index.ts.
Tags
Tech Stack
Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.