devclaw

module
v1.17.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Apr 1, 2026 License: MIT

README

DevClaw

AI agent for tech teams. Single binary. Runs everywhere.

Release Go CI

DevClaw

Open-source AI agent for tech teams. Single Go binary with CLI, WebUI, MCP server, and messaging channels. Full system access, persistent memory, encrypted vault, and 90+ built-in tools.

Not a chatbot. Not an IDE. Not a framework. DevClaw is the AI backend that IDEs, terminals, and channels access — giving any tool persistent memory, infrastructure access, and integrations.

Docs | Getting Started | Skills | Releases


Quick Start

# Linux/macOS — one-command install
bash <(curl -fsSL https://raw.githubusercontent.com/jholhewres/devclaw/master/install/unix/install.sh)

# Docker
git clone https://github.com/jholhewres/devclaw.git && cd devclaw
docker compose up -d

# From source (Go 1.24+ & Node 22+)
git clone https://github.com/jholhewres/devclaw.git && cd devclaw
make build && ./bin/devclaw serve

Open http://localhost:47716/setup to configure your API key.

See install/DEPLOYMENT.md for all install options (Docker, systemd, Ansible, Windows, uninstall).


Highlights

Interfaces: CLI / WebUI / WhatsApp / Telegram
     │
     ▼
Assistant (agent loop) ─── LLM Client (9 providers, N-fallback)
     │
     ├── Tools (90+)        — files, git, docker, databases, testing, deploy
     ├── Memory (SQLite)    — FTS5 + vector embeddings, persistent across sessions
     ├── Subagents (8x)     — concurrent child agents with isolated sessions
     ├── MCP Server         — stdio + SSE for IDE integration
     └── Plugin System      — YAML-first agents, tools, hooks, skills
  • 9 LLM providers with N-provider fallback chain and budget tracking
  • 90+ tools across 22 categories (files, git, docker, databases, testing, ops, media, web)
  • MCP server for IDE integration (Cursor, VSCode, Windsurf, Zed, Neovim)
  • Plugin agents with custom instructions, triggers, and bidirectional escalation
  • Encrypted vault (AES-256-GCM + Argon2id) for all secrets
  • Pipe modegit diff | devclaw diff or npm build 2>&1 | devclaw fix
  • Skills — install from ClawHub or create your own

CLI

devclaw serve                  # Start daemon with channels + WebUI
devclaw chat "message"         # Single message or interactive REPL
devclaw mcp serve              # MCP server for IDE integration

devclaw fix [file]             # Analyze and fix errors
devclaw explain [path]         # Explain code or directories
devclaw diff [--staged]        # AI review of git changes
devclaw commit [--dry-run]     # Generate commit message and commit
devclaw how "task"             # Generate shell commands

git diff | devclaw "review"    # Pipe mode

MCP Server

devclaw mcp serve    # starts MCP server on stdio
{
  "mcpServers": {
    "devclaw": {
      "command": "devclaw",
      "args": ["mcp", "serve"]
    }
  }
}

Works with Cursor, VSCode, Windsurf, Zed, Neovim, and any MCP-compatible client.


Documentation

Topic Link
Architecture docs/architecture.md
Features docs/features.md
Tools (90+) docs/features.md#tools
Channels docs/channels.md
Plugins docs/plugins.md
Security docs/security.md
Performance docs/performance.md
Skills Catalog docs/skills-catalog.md
Deployment install/DEPLOYMENT.md
Configuration configs/devclaw.example.yaml

Author

Jhol Hewres@jholhewres

License

MIT

Directories

Path Synopsis
cmd
devclaw command
Package main é o ponto de entrada do CLI do DevClaw.
Package main é o ponto de entrada do CLI do DevClaw.
devclaw/commands
Package commands – changelog.go implements the `devclaw changelog` CLI command that displays the changelog for the current version.
Package commands – changelog.go implements the `devclaw changelog` CLI command that displays the changelog for the current version.
pkg
devclaw/auth/profiles
Package profiles provides multi-account authentication management for DevClaw.
Package profiles provides multi-account authentication management for DevClaw.
devclaw/channels
Package channels defines the interfaces and types for DevClaw communication channels.
Package channels defines the interfaces and types for DevClaw communication channels.
devclaw/channels/discord
Package discord - components.go provides reusable interactive component handling for Discord (buttons, select menus) with registration, TTL-based cleanup, AllowedUsers restriction, and Reusable behavior.
Package discord - components.go provides reusable interactive component handling for Discord (buttons, select menus) with registration, TTL-based cleanup, AllowedUsers restriction, and Reusable behavior.
devclaw/channels/slack
Package slack implements the Slack channel for DevClaw using the Slack Web API and Socket Mode for real-time events — no external dependencies beyond HTTP.
Package slack implements the Slack channel for DevClaw using the Slack Web API and Socket Mode for real-time events — no external dependencies beyond HTTP.
devclaw/channels/telegram
Package telegram – errors.go defines structured error types for the Telegram Bot API, enabling callers to classify and handle API failures.
Package telegram – errors.go defines structured error types for the Telegram Bot API, enabling callers to classify and handle API failures.
devclaw/channels/whatsapp
Package whatsapp – dedup.go provides a message deduplication cache to filter out duplicate messages during WhatsApp reconnections.
Package whatsapp – dedup.go provides a message deduplication cache to filter out duplicate messages during WhatsApp reconnections.
devclaw/copilot
Package copilot – abort.go implements abort trigger detection for stopping active agent runs using natural language phrases in multiple languages.
Package copilot – abort.go implements abort trigger detection for stopping active agent runs using natural language phrases in multiple languages.
devclaw/copilot/memory
Package memory – embeddings.go implements embedding generation for semantic search.
Package memory – embeddings.go implements embedding generation for semantic search.
devclaw/copilot/security
Package security – audit.go implements security auditing for DevClaw configuration.
Package security – audit.go implements security auditing for DevClaw configuration.
devclaw/database
Package database provides a unified database abstraction layer (Database Hub) that supports multiple backends (SQLite, PostgreSQL, MySQL) with a common interface.
Package database provides a unified database abstraction layer (Database Hub) that supports multiple backends (SQLite, PostgreSQL, MySQL) with a common interface.
devclaw/database/backends
Package backends provides database backend implementations.
Package backends provides database backend implementations.
devclaw/gateway
Package gateway – channel_health_monitor.go monitors the health of active channels (WebSocket connections, long-running integrations) and restarts stale ones with cooldown and rate limiting.
Package gateway – channel_health_monitor.go monitors the health of active channels (WebSocket connections, long-running integrations) and restarts stale ones with cooldown and rate limiting.
devclaw/mcp
Package mcp implements a Model Context Protocol server that exposes DevClaw tools, resources, and prompts to MCP-compatible clients (Cursor, VSCode, etc.) via stdio and SSE transports.
Package mcp implements a Model Context Protocol server that exposes DevClaw tools, resources, and prompts to MCP-compatible clients (Cursor, VSCode, etc.) via stdio and SSE transports.
devclaw/media
Package media provides native media handling for DevClaw.
Package media provides native media handling for DevClaw.
devclaw/oauth
Package oauth provides OAuth 2.0 authentication for LLM providers.
Package oauth provides OAuth 2.0 authentication for LLM providers.
devclaw/oauth/providers
Package providers implements OAuth providers for various LLM services.
Package providers implements OAuth providers for various LLM services.
devclaw/paths
Package paths provides centralized path resolution for the DevClaw application.
Package paths provides centralized path resolution for the DevClaw application.
devclaw/plugins
Package plugins – installer.go implements plugin installation from multiple sources: GitHub repositories and local paths.
Package plugins – installer.go implements plugin installation from multiple sources: GitHub repositories and local paths.
devclaw/sandbox
Package sandbox – exec_direct.go implements the direct executor (IsolationNone).
Package sandbox – exec_direct.go implements the direct executor (IsolationNone).
devclaw/scheduler
Package scheduler – nlp_schedule.go parses natural language schedule expressions into cron/every/at formats.
Package scheduler – nlp_schedule.go parses natural language schedule expressions into cron/every/at formats.
devclaw/skills
Package skills – builtin_adapter.go provides a SkillLoader that creates lightweight built-in skills.
Package skills – builtin_adapter.go provides a SkillLoader that creates lightweight built-in skills.
devclaw/tls
Package tls provides self-signed TLS certificate generation and loading for DevClaw's HTTPS support.
Package tls provides self-signed TLS certificate generation and loading for DevClaw's HTTPS support.
devclaw/tts
Package tts provides text-to-speech synthesis for DevClaw.
Package tts provides text-to-speech synthesis for DevClaw.
devclaw/updater
Package updater implements auto-update checking and installation for DevClaw.
Package updater implements auto-update checking and installation for DevClaw.
devclaw/webui
Package webui – media_handlers.go provides HTTP handlers for media upload/download.
Package webui – media_handlers.go provides HTTP handlers for media upload/download.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL