Wirasm / kild

KILD Manage parallel AI development agents in isolated Git worktrees. Overview KILD eliminates context switching between scattered terminals when working with multiple AI coding assistants. Each kild runs in its own Git worktree with automatic branch creation, allowing you to manage parallel AI development sessions from a centralized interface. Features • **Isolated Worktrees**: Each kild gets its own Git worktree with unique branch • **Dual Runtime Modes**: Choose between external terminal windows or daemon-owned PTYs • **Session Persistence**: Daemon-managed sessions survive terminal restarts (experimental) • **Agent Teams**: Daemon sessions support Claude Code agent teams via tmux-compatible shim • **Session Tracking**: Persistent registry tracks all active kilds • **Cross-Platform**: Works on macOS, Linux, and Windows • **Agent-Friendly**: Designed for programmatic use by AI assistants • **Visual Verification**: Companion tool for capturing screenshots and inspecting native UI (see ) GUI (Experimental) A native graphical interface is under development using GPUI. The UI provides visual kild management as an alternative to the CLI. The GUI currently supports: • Multi-project management: Project rail (48px) with icon-based switcher and badge counts • Sidebar navigation: Kilds grouped by Active/Stopped status with nested terminal tab names • KILD listing with status indicators (running, stopped, git dirty state) • Creating new kilds with agent selection • Opening new agents in existing kilds • Stopping agents without destroying kilds • Destroying kilds with confirmation dialog • Quick actions: Copy path to clipboard, open in editor, focus terminal window • Live terminal rendering with multiple tabs per kild • Keyboard navigation: Ctrl+1-9 (jump to kild by index), Cmd+Shift+[/] (cycle workspaces), Cmd+J/K (next/prev kild), Cmd+D (toggle Control/Dashboard view), Ctrl+Escape (move focus from terminal to sidebar) — all configurable via See the PRD for the development roadmap. Installation Usage Global flags Create a new kild List active kilds Navigate to a kild (shell integration) Open a new agent in an existing kild Open kild in code editor Focus on a kild **Note:** Daemon-managed sessions automatically open an attach window. If auto-attach fails, use to connect manually. Hide a kild **Note:** Daemon-managed sessions have no persistent window to hide (attach windows are ephemeral). Use to reconnect if needed. View git changes in a kild Show recent commits View branch health Detect file overlaps Show PR status Daemon management (experimental) **Note**: Daemon mode is experimental (Phase 1b). The daemon runtime supports background and foreground modes, auto-start via config, scrollback replay on attach, PTY exit notification with automatic session state updates, and works with both and commands. When creating or opening daemon sessions, KILD automatically spawns a terminal attach window for immediate visual feedback. Daemon sessions automatically enable Claude Code agent teams by injecting a tmux-compatible shim. Inject a message to a running worker **Note**: For Claude daemon sessions, inject uses the inbox polling protocol by default (message delivered as a new user turn within ~1s). For all other agents, it writes to PTY stdin. The worker should be idle before injecting. Inspect fleet dropbox state Generate fleet context for agent bootstrapping **Note**: Returns an error if fleet mode is not active. Designed for use in brain→worker injection: . Manage the project registry Stop a kild Get kild information Destroy a kild Clean up orphaned kilds Configuration KILD uses a hierarchical TOML configuration system: • **User config**: (global settings) • **Project config**: (project-specific settings) • **User keybindings**: (UI keyboard shortcuts) • **Project keybindings**: (project-specific overrides) • **Defaults**: Built-in sensible defaults See for all config options. Keybindings follow the same hierarchy — project overrides user, missing keys fall back to defaults. Key Configuration Features **File Include Patterns**: By default, KILD copies certain files to new worktrees even if gitignored: • - Environment files • - Local config files • - Claude AI context files • - Cursor AI context files Configure additional patterns in section. Your patterns extend the defaults. **Agent Settings**: Configure default agent, startup commands, and flags per agent. **Terminal Preferences**: Set preferred terminal emulator (Ghostty, iTerm2, Terminal.app on macOS; Alacritty on Linux). **Editor Settings**: Configure default editor for command with optional flags and terminal mode for terminal-based editors. **Daemon Runtime**: Control whether sessions run in daemon-owned PTYs by default: How It Works • **Worktree Creation**: Creates a new Git worktree in with a unique branch • **File Copying**: Copies configured patterns (env files, AI context) to worktree • **Agent Launch**: Launches the specified agent command in a native terminal window • **Session Tracking**: Records session metadata in • **Lifecycle Management**: Provides commands to monitor, stop, and clean up sessions Requirements • Rust 1.89.0 or later • Git repository (kild must be run from within a Git repository) • Native terminal emulator (Ghostty/iTerm2/Terminal.app on macOS, Alacritty + Hyprland on Linux) Agent Integration KILD is designed to be used by AI agents themselves. For example, an AI assistant can create a new kild for a specific task: This enables parallel AI workflows without manual terminal management. Architecture • **CLI**: Built with clap for structured command parsing • **Git Operations**: Uses git2 crate for worktree management • **Terminal Launching**: Platform-specific terminal integration • **Session Registry**: JSON-based persistent storage • **Cross-Platform**: Conditional compilation for platform features License Apache License 2.0 — free to use, modify, and distribute.…