craft-agents-oss: Manage AI Agent Work in a Desktop App

Overview

Craft Agents brings AI agent sessions into a desktop workspace rather than a purely command-line workflow. It helps users manage multiple conversations, connect agents to external services and local files, and keep reusable skills and session history organized by workspace.

It is aimed at people who want to work with agents across varied tasks and integrations, with control over permissions and provider choice. A headless server and CLI extend the same system to remote machines and scripted workflows.

Key Features

• Manage multiple sessions with inbox, archive, status, and flagging workflows.
• Connect MCP servers, REST APIs, and local filesystems as workspace sources.
• Use multiple LLM connections, including Anthropic, Google AI Studio, ChatGPT Plus, GitHub Copilot, and compatible custom endpoints.
• Set permission modes for read-only exploration, approval before edits, or automatic approval.
• Create workspace-specific skills and event-driven automations.
• Run a remote headless server and connect through the desktop app or CLI.
• Store credentials in encrypted local storage and filter sensitive environment variables from local MCP subprocesses.

Use Cases

• A knowledge worker can organize research, document, and service-related agent sessions in one workspace.
• A developer can give an agent access to project files, APIs, or MCP servers while choosing how much permission to grant.
• A team member can automate recurring prompts, such as scheduled briefings or reactions to session labels.
• A user with a remote or more powerful machine can keep sessions running on a headless server and connect from the desktop client.
• A developer can use the CLI to send prompts, inspect sessions, or validate a server in scripts and CI workflows.

Getting Started

Install the desktop app on macOS or Linux:

curl -fsSL https://thecraftagents.com/install-app.sh | bash

For Windows installation, source builds, and configuration details, see the repository README.

Alternatives

• goose: Goose is a general-purpose agent for tasks like coding and research, while Craft Agents centers on organizing agent sessions in a customizable workspace.
• tessera: Tessera focuses on coordinating coding sessions from Claude Code, Codex, and OpenCode, while Craft Agents offers a broader workspace for agent sessions and services.

Considerations

• Using provider-backed models requires the relevant API credentials or supported subscription authentication. Some integrations, including Google and certain OAuth sources, require users to supply credentials.
• Building from source requires Bun. The desktop application is built with Electron.
• The allow-all permission mode approves commands automatically. Choose a more restrictive mode when approval is important.
• Remote server access exposes a WebSocket service and requires a bearer token. The project recommends TLS when exposing it over a network.
• The README describes integrations and setup, but does not establish that every external service or provider works without additional configuration.