# craft-agents-oss | Craft Docs | Knowledge Base | Instagit

GitHub Stars: 4.3k

Repository: https://github.com/lukilabs/craft-agents-oss

---

## Articles

### [Background Task Management in Craft-Agents: A Technical Deep Dive](/lukilabs/craft-agents-oss/background-task-management-strategy)

Explore background task management in Craft-Agents. Learn how its pipeline detects flags, tracks tasks by agent IDs, and groups child activities for a superior UI experience. Discover the technical approach.

- Tags: deep-dive
- Published: 2026-04-18

### [How the Status System Enables Workflow Customization in Craft Agents](/lukilabs/craft-agents-oss/status-system-and-workflow-customization)

Discover how the Craft Agents status system customizes workflows. Learn how configurable states and automations manage sessions effectively with SessionStatus and statuses/config.json.

- Tags: deep-dive
- Published: 2026-04-18

### [How Large Responses Are Handled and Summarized in Craft-Agents-OSS](/lukilabs/craft-agents-oss/large-response-handling-and-summarization)

Craft-Agents-OSS automatically handles large responses by detecting binary data, extracting assets, persisting payloads, and summarizing to prevent context overflow.

- Tags: how-to-guide
- Published: 2026-04-18

### [How the Search Tool Provider is Implemented in Craft Agents OSS](/lukilabs/craft-agents-oss/search-tool-provider-implementation)

Discover how the search tool provider is implemented in Craft Agents OSS. Explore its pluggable architecture, factory function, and resilient DuckDuckGo fallback with exponential backoff retries.

- Tags: how-to-guide
- Published: 2026-04-18

### [Using Custom Endpoints for Model Resolution in Craft Agents](/lukilabs/craft-agents-oss/custom-endpoint-model-resolution)

Learn how to use custom endpoints for model resolution in Craft Agents. Prioritize your LLMs by configuring custom endpoints before standard providers.

- Tags: how-to-guide
- Published: 2026-04-18

### [Craft Agents Docker Deployment and TLS Configuration: A Complete Guide](/lukilabs/craft-agents-oss/docker-deployment-and-tls-configuration)

Deploy Craft Agents OSS with Docker and configure TLS encryption. Learn to enable wss:// using PEM certificates and environment variables for secure headless server deployment. Complete guide.

- Tags: how-to-guide
- Published: 2026-04-18

### [Deep Linking URL Scheme Handler Implementation in Craft Agents OSS](/lukilabs/craft-agents-oss/deep-linking-url-scheme-handler)

Implement deep linking with the craftagents:// URL scheme in Craft Agents OSS. Parse links, route commands, and render views efficiently.

- Tags: deep-dive
- Published: 2026-04-18

### [How the OAuth Flow Is Implemented for Google, Slack, and Microsoft Integrations in Craft-Agents OSS](/lukilabs/craft-agents-oss/oauth-flow-implementation-google-slack-microsoft)

Explore the OAuth flow implementation in Craft-Agents OSS for Google, Slack, and Microsoft integrations. Learn about PKCE, HTTP Basic auth, and a shared callback server.

- Tags: how-to-guide
- Published: 2026-04-18

### [How Craft-Agents Enforces File System Isolation and Path Security](/lukilabs/craft-agents-oss/file-system-isolation-and-path-security)

Discover how Craft-Agents enforces file system isolation and path security using session validation, filename sanitization, and atomic operations for a secure workspace.

- Tags: internals
- Published: 2026-04-18

### [How Session Tool Definitions Are Managed and the Filtering Mechanism in Craft Agents](/lukilabs/craft-agents-oss/tool-definitions-and-filtering-mechanism)

Discover how session tool definitions are managed in <CODE>SESSION_TOOL_DEFS</CODE> and explore the filtering mechanism in Craft Agents for precise control over tool subsets by mode and flags.

- Tags: internals
- Published: 2026-04-18

### [Craft Agents WebSocket Protocol: Custom JSON-RPC Communication Between Desktop and Server](/lukilabs/craft-agents-oss/websocket-protocol-between-desktop-and-server)

Discover the custom JSON-RPC protocol powering WebSocket communication in Craft Agents. Learn about typed requests, event streaming, and reliable connections between desktop and server.

- Tags: api-reference
- Published: 2026-04-18

### [CLI Client Commands for Scripting: Complete Reference to Craft Agents Document Automation Tools](/lukilabs/craft-agents-oss/cli-client-commands-and-scripting)

Explore the Craft Agents OSS CLI client commands for scripting document automation. Discover over 40 sub-commands for conversion comparison and manipulation.

- Tags: api-reference
- Published: 2026-04-18

### [How the Craft Agents Skills System Works: Implementation and Custom Instruction Storage](/lukilabs/craft-agents-oss/skills-system-and-custom-instructions-storage)

Learn how the Craft Agents skills system works. Discover custom instruction storage in SKILLmd files and its three tier loading hierarchy with 5-minute caching.

- Tags: internals
- Published: 2026-04-18

### [REST API Source Configuration Options in Craft Agents OSS: A Complete Guide](/lukilabs/craft-agents-oss/rest-api-source-configuration)

Explore REST API source configuration options in Craft Agents OSS. Learn about endpoint URLs, authentication, request defaults, and OAuth for seamless API integration.

- Tags: how-to-guide
- Published: 2026-04-18

### [How the Craft-Agents Theme System and Cascading Configuration Work](/lukilabs/craft-agents-oss/theme-system-and-cascading-configuration)

Understand the Craft-Agents theme system and cascading configuration. Explore how layered architecture, preset themes, and global overrides create final CSS variables for ultimate control.

- Tags: deep-dive
- Published: 2026-04-18

### [Understanding the Automation Event System and Cron-Based Triggers in Craft Agents](/lukilabs/craft-agents-oss/automation-event-system-cron-triggers)

Explore Craft Agents automation event system and cron-based triggers. Learn how the publish/subscribe architecture executes actions on specific events using the SchedulerTick event for scheduled tasks.

- Tags: deep-dive
- Published: 2026-04-18

### [How Craft Agents Implements Multi-Provider LLM Routing: A Deep Dive into the Provider-Agnostic Backend](/lukilabs/craft-agents-oss/multi-provider-llm-routing-strategy)

Discover how Craft Agents implements multi-provider LLM routing using a centralized factory for provider-agnostic backend operations. Learn its unique approach for seamless LLM integration.

- Tags: deep-dive
- Published: 2026-04-18

### [How Craft-Agents Persists Sessions and Stores Message History: A Technical Deep Dive](/lukilabs/craft-agents-oss/session-persistence-and-message-history-storage)

Discover how Craft-Agents persists sessions and stores message history using JSON Lines and atomic writes. Ensure data integrity with portable paths for seamless migration.

- Tags: deep-dive
- Published: 2026-04-18

### [Credential Encryption Implementation in Craft Agents: A Deep Dive into SecureStorageBackend](/lukilabs/craft-agents-oss/credential-encryption-implementation-details)

Learn about Craft Agents credential encryption using AES-256-GCM and PBKDF2. Discover how your secrets are securely stored in lukilabs/craft-agents-oss.

- Tags: deep-dive
- Published: 2026-04-18

### [How MCP Server Integration Handles Security and Isolation in Craft Agents](/lukilabs/craft-agents-oss/mcp-server-integration-security-isolation)

Learn how Craft Agents secures MCP server integration with defense-in-depth: validation, workspace guards, credential isolation, and permission policies prevent unauthorized access and data leaks.

- Tags: internals
- Published: 2026-04-18

### [Craft Agents Headless Server and Thin‑Client Desktop App Architecture](/lukilabs/craft-agents-oss/architecture-of-headless-server-and-thin-client-app)

Explore the Craft Agents OSS architecture featuring a Bun headless server for AI tasks and session persistence, plus an Electron thin client using WebSocket RPC for remote UI rendering. Discover its split design.

- Tags: architecture
- Published: 2026-04-18

### [How the Craft Agents Permission Mode System Works: A Technical Deep Dive](/lukilabs/craft-agents-oss/how-does-craft-agents-permission-mode-system-work)

Understand the Craft Agents permission mode system, controlling tool execution from read-only to automatic. Learn how modes are stored and validated for secure session control.

- Tags: deep-dive
- Published: 2026-04-18