# lukilabs/craft-agents-oss **Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/lukilabs-craft-agents-oss).** 2,888 stars · 409 forks · TypeScript · apache-2.0 ## Links - GitHub: https://github.com/lukilabs/craft-agents-oss - awesome-repositories: https://awesome-repositories.com/repository/lukilabs-craft-agents-oss.md ## Description Craft Agents is an open-source desktop application that serves as a unified hub for managing multiple AI agents and their providers from a single interface. It connects to services including Anthropic, Google AI Studio, ChatGPT Plus, and GitHub Copilot, while also supporting any OpenAI-compatible endpoint, with the ability to set per-workspace provider defaults for each session. The application operates on a client-server architecture that decouples the agent runtime into a remote server process and a thin desktop client, enabling sessions to persist across machines. It includes a WebSocket-based CLI interface for terminal-based agent interaction suitable for scripting and CI/CD pipeline integration, along with an event-driven automation engine that triggers agent workflows based on label changes, schedules, and tool-use events through a configurable rule system. Craft Agents provides granular permission control that intercepts agent actions at runtime to enforce read-only, ask-to-edit, or auto-approve modes with dynamic mode cycling during conversations. The system integrates with external data sources through a protocol adapter that translates natural language requests into structured calls to Model Context Protocol servers, REST APIs, and local data sources, while also supporting natural language API discovery that automatically configures credentials for external services. Sessions are organized through a visual inbox with status workflows, flagging, and full history persistence to disk for continuity across restarts. ## Tags ### Artificial Intelligence & ML - [Desktop AI Agents](https://awesome-repositories.com/f/artificial-intelligence-ml/desktop-ai-agents.md) — Opens a native desktop application that manages connections to multiple AI agents and APIs through a graphical interface. ([source](https://github.com/lukilabs/craft-agents-oss/tree/main/docs/)) - [Agent Server Hosting](https://awesome-repositories.com/f/artificial-intelligence-ml/agent-communication-protocols/agent-client-protocols/agent-server-hosting.md) — Operates the agent as a headless server on a remote machine for persistent, long-running sessions via a thin client. ([source](https://cdn.jsdelivr.net/gh/lukilabs/craft-agents-oss@main/README.md)) - [Agent Connection Management](https://awesome-repositories.com/f/artificial-intelligence-ml/agent-connection-management.md) — Connects to multiple AI agent services from a single desktop environment to manage all interactions. ([source](https://github.com/lukilabs/craft-agents-oss/tree/main/docs/)) - [Multi-Provider Orchestrators](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/agent-orchestration-multi-agent/coordination-and-routing/ai-agent-orchestrators/multi-provider-orchestrators.md) — Routes messages between a local desktop client and multiple remote AI agent endpoints through a unified connection manager. - [Provider Switching](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/model-integration-serving/model-integration-interfaces/ai-integration-apis/openai-compatible-apis/provider-switching.md) — Switches between multiple AI providers and sets per-workspace defaults for each session. ([source](https://cdn.jsdelivr.net/gh/lukilabs/craft-agents-oss@main/README.md)) - [Conversation Organizers](https://awesome-repositories.com/f/artificial-intelligence-ml/predictive-user-interfaces/conversational-ai-interfaces/conversation-organizers.md) — Organizes conversations with status workflows, flagging, AI-generated titles, and full history persistence to disk. ([source](https://cdn.jsdelivr.net/gh/lukilabs/craft-agents-oss@main/README.md)) ### Development Tools & Productivity - [Session State Persistence](https://awesome-repositories.com/f/development-tools-productivity/database-session-management/session-state-persistence.md) — Maintains full conversation history and state to disk for session continuity across restarts and machine switches. - [MCP Protocol Adapters](https://awesome-repositories.com/f/development-tools-productivity/rest-apis/mcp-protocol-adapters.md) — Translates natural language requests into structured calls to Model Context Protocol servers, REST APIs, and local data sources. - [Headless Agent Servers](https://awesome-repositories.com/f/development-tools-productivity/terminal-text-editors/client-server-architectures/headless-agent-servers.md) — Decouples the agent runtime into a remote server process and a thin desktop client for persistent sessions across machines. - [Workspace-Specific Provider Selections](https://awesome-repositories.com/f/development-tools-productivity/dynamic-configuration-providers/dynamic-provider-registration/automated-provider-selection/workspace-specific-provider-selections.md) — Picks from multiple AI providers to assign a specific backend per workspace. ([source](https://cdn.jsdelivr.net/gh/lukilabs/craft-agents-oss@main/README.md)) - [Event-Driven Automation Engines](https://awesome-repositories.com/f/development-tools-productivity/event-driven-automation-engines.md) — Triggers agent sessions and workflows by monitoring label changes, schedules, and tool-use events. ### Operating Systems & Systems Programming - [Agent Permission Modes](https://awesome-repositories.com/f/operating-systems-systems-programming/package-file-permission-management/raw-mode-permission-constructors/agent-permission-modes.md) — Intercepts agent actions at runtime to enforce read-only, ask-to-edit, or auto-approve modes with dynamic cycling. ### System Administration & Monitoring - [Visual Inboxes](https://awesome-repositories.com/f/system-administration-monitoring/administrative-operations/configuration-control-utilities/administrative-controls/session-management/conversational-session-managers/visual-inboxes.md) — Provides a visual inbox with status workflows, flagging, and full history persistence for organizing agent conversations. ([source](https://cdn.jsdelivr.net/gh/lukilabs/craft-agents-oss@main/README.md)) - [Desktop Inbox Managers](https://awesome-repositories.com/f/system-administration-monitoring/administrative-operations/configuration-control-utilities/administrative-controls/session-management/conversational-session-managers/desktop-inbox-managers.md) — Manages multiple concurrent agent conversations with an inbox, status workflow, flagging, and full history saved to disk. ([source](https://cdn.jsdelivr.net/gh/lukilabs/craft-agents-oss@main/README.md)) ### Data & Databases - [External Data Integrations](https://awesome-repositories.com/f/data-databases/external-data-integrations.md) — Pulls data from MCP servers, REST APIs, local files, and databases through natural language requests or configuration. ([source](https://cdn.jsdelivr.net/gh/lukilabs/craft-agents-oss@main/README.md)) ### DevOps & Infrastructure - [Workflow Event Triggers](https://awesome-repositories.com/f/devops-infrastructure/workflow-event-triggers.md) — Triggers automated agent sessions using natural language prompts when events like label changes or schedules occur. ([source](https://cdn.jsdelivr.net/gh/lukilabs/craft-agents-oss@main/README.md)) ### Networking & Communication - [WebSocket-Based CLI Exposure](https://awesome-repositories.com/f/networking-communication/remote-access-control/websocket-based-cli-exposure.md) — Connects a terminal client to a running agent server over WebSocket for scripting and CI/CD pipeline integration. ### Software Engineering & Architecture - [Automatic Credential Configurations](https://awesome-repositories.com/f/software-engineering-architecture/api-abstraction-layers/natural-language-tool-interfaces/automatic-credential-configurations.md) — Describes an external service in natural language so the agent discovers and configures the API automatically. ([source](https://cdn.jsdelivr.net/gh/lukilabs/craft-agents-oss@main/README.md))