ClawDE

The host-first AI development environment.

One daemon. Every provider. Any device.

Description

ClawDE is a host-first AI developer environment. One always-on local daemon (clawd) owns the filesystem, sessions, validators, and orchestration. Flutter apps on desktop and mobile are thin JSON-RPC 2.0 clients of that daemon, so every device sees the same state.

The daemon is the source of truth, not any UI. That means no cold starts, no drift between sessions, and no agent inventing files that aren't on disk. Works with Claude Code, Codex, Cursor, and Aider through one interface.

Documentation

See the Wiki for full documentation:

• Getting Started
• Architecture
• Features
• Contributing
• Changelog

Quick Start

# Clone the repo
git clone https://github.com/nself-org/clawde.git
cd clawde

# Bootstrap Dart/Flutter workspace
cd apps
dart pub global activate melos
melos bootstrap

# Build and run the daemon
cd daemon && cargo build --release

# Run the desktop app
cd ../desktop && flutter run

See Getting Started for full setup instructions.

Structure

apps/         # All application code
  daemon/     # clawd — Rust/Tokio daemon
  desktop/    # Flutter desktop app (macOS/Windows/Linux)
  mobile/     # Flutter mobile app (iOS/Android)
  packages/   # Shared Dart packages
site/         # Website (clawde.io)
.github/      # CI/CD workflows, wiki source, brand assets

Features

• Host-first daemon (clawd) owns sessions, filesystem state, and orchestration
• Works with Claude Code, Codex, Cursor, and Aider through one interface
• Desktop apps for macOS, Windows, and Linux
• Mobile companion for iOS and Android (review and approve agent runs from anywhere)
• Multi-account switching when one provider hits a rate limit
• Task worktrees: each AI task gets its own git branch you can accept or reject
• LAN discovery via mDNS plus an outbound mTLS relay for off-LAN access
• End-to-end encryption for remote sessions
• SQLite-backed local state (no external DB)
• Free for local use, open source under MIT

Installation

macOS

brew tap nself-org/clawde
brew install clawd

macOS / Linux (one-liner)

curl -fsSL https://clawde.io/install.sh | bash

Windows

Download the clawd-x86_64-pc-windows-msvc.exe binary from the Releases page and place it on your PATH. The Flutter desktop app installs separately via the platform-specific build (see Wiki / Getting-Started).

Build from source

git clone https://github.com/nself-org/clawde.git
cd clawde/apps
dart pub global activate melos
melos bootstrap
cd daemon && cargo build --release
cd ../desktop && flutter run -d macos

Usage

# Start the daemon (listens on ws://localhost:4300)
clawd start

The desktop and mobile apps connect to that WebSocket and stay in sync.

# Pair a mobile device
clawd pair --show-qr

Scan the QR with the mobile app to trust the device.

# Run a session against Claude Code
clawd session new --provider claude-code

The daemon spawns the provider CLI and brokers messages over JSON-RPC.

Architecture

ClawDE is built around a single Rust daemon (clawd) that holds session state in embedded SQLite, brokers JSON-RPC 2.0 over WebSocket, and supervises provider CLIs (Claude Code, Codex, Cursor, Aider). Flutter clients on desktop and mobile share Dart packages (clawd_proto, clawd_client) and never talk to providers directly. ClawDE Cloud is a proprietary fork hosted by us; the open-source code in this repo covers the self-hosted mode entirely.

See the Architecture wiki page for the deep-dive.

Contributing

See Contributing for the contributor guide.

License

MIT. See LICENSE.

Related Repos

• nself-org/cli: the nSelf CLI. ClawDE+ sync features run on top of an nSelf backend.
• nself-org/plugins-pro: license-gated pro plugins. ClawDE+ Bundle pulls cloud sync / mobile twin features from here.
• nself-org/web: clawde.io marketing site, api.clawde.io relay, and cloud.clawde.io Cloud product surface.