Manage agent workflows in a desktop environment
You do not need to edit configuration files directly or navigate complex wizards to connect agents to external services like Linear or Gmail. If you tell the agent to add Linear as a source, it finds the public API and documentation, sets up credentials, and configures everything. Craft Agents is a desktop application that focuses on document-centric workflows, allowing you to control agent behavior with prompts alone without writing code directly.
Installation and initial run
You can install the app with a single command on macOS and Linux. On Windows, the same installation is possible via PowerShell. After installation, run the app to connect by selecting one of the following: an Anthropic API key, Claude Max, Google AI Studio, ChatGPT Plus, or GitHub Copilot. Create a workspace, connect the necessary sources, and start chatting. To build from source code, use the bun install and bun run electron:start commands.
Agent-native workflow
The core of this tool is that the agent finds the execution method when you describe the desired result. It handles connections to various sources, such as MCP servers, REST APIs, and local file systems, automatically without configuration files. If you request the agent to migrate skills or MCP settings used in Claude Code, it imports them automatically. When creating new skills, the agent handles the rest after you describe the functionality and provide context, with changes reflected immediately without requiring a restart.
Session management and permission control
Sessions are organized by workflow status through inbox, archive, and flagging. Statuses can be customized as 'To do', 'In progress', 'Needs review', 'Completed', and so on. Permission modes are divided into three stages: 'Explore', 'Edit approval', and 'Auto', which can be switched during chat using the SHIFT+TAB key. The 'Explore' mode is read-only and blocks all write operations, while 'Edit approval' is the default and requests approval before writing. The 'Auto' mode automatically approves all commands.
Remote server and CLI client
Craft Agents runs as a headless server, allowing you to maintain long-running sessions on remote machines or access them from multiple devices. The desktop app acts as a thin client, with session logic, tool execution, and LLM calls handled by the remote server. The CLI client used in the terminal can be utilized for scripting or CI/CD pipelines, and the run command supports self-contained operation that creates a server, executes a prompt, and then terminates. When exposing to the network, it is recommended to set up a TLS certificate to encrypt WebSocket connections.
Pre-use considerations
This project is released under the Apache 2.0 license, allowing free modification and reuse. However, because it uses the Claude Agent SDK, Anthropic's commercial service terms apply. When integrating Google services, you must generate and configure your own OAuth credentials in a Google Cloud project, while Slack and Microsoft require credentials to be included at build time. When running local MCP servers, sensitive environment variables are automatically filtered to prevent credential leakage. When exposing a remote server to the network, you must set up TLS, and in production environments, you should use a trusted CA certificate or run behind a reverse proxy.