aigentry-devkit

aigentry-devkit

Part of the aigentry platform — AI 의사결정을 감사 가능하게 만드는 오픈소스 엔진. aigentry-devkit is Layer 3: developer tools, hooks, and automation for the aigentry ecosystem.

Your AI development environment, packaged.

A comprehensive development kit that bundles skills, hooks, MCP servers, HUD/statusline, and configuration templates for Claude Code, Codex CLI, and other MCP-compatible CLIs. Install once, use everywhere.

Features

Skills (Reusable AI Capabilities)

Bundled skills that extend Claude Code, Codex CLI, and other MCP-compatible CLIs:

• Clipboard Image Viewer - Capture and analyze clipboard images directly from your terminal
• AI Deliberation - Multi-session parallel debates across arbitrary CLI participants with structured turn-taking and synthesis
• Deliberation Executor - Convert deliberation synthesis into concrete implementation tasks and execute them
• Environment Manager - direnv-based hierarchical environment variable management with global and project-scoped variables
• Telepty Deliberate - Start bidirectional multi-session deliberation across active telepty sessions with session mapping and fallback routing
• YouTube Analyzer - Extract and analyze YouTube video metadata, captions, and transcripts without downloading

MCP Deliberation Server

A dedicated MCP (Model Context Protocol) server enabling multi-session AI debates with:

• Parallel deliberation sessions with independent state management
• Structured response formats (evaluation, core position, reasoning, risks, synthesis)
• Automatic session monitoring with optional tmux integration
• State persistence and session history archiving

HUD/Statusline

Custom statusline display for Claude Code that shows real-time context from stdin, with support for extended context windows (up to 1M tokens on Claude Opus).

Hooks

Session-start bootstrap hooks that automatically load skill indices and prepare your environment when Claude Code starts.

Configuration Templates

Pre-configured settings with template substitution:

• settings.json.template - Claude Code settings with {{HOME}} substitution
• global.envrc - direnv configuration for hierarchical environment management
• CLAUDE.md - AI agent instructions (oh-my-claudecode compatible)

Installation

Prerequisites

• Node.js 18+
• npm (included with Node.js)
• Optional: Claude Code CLI (npm install -g @anthropic-ai/claude-code)
• Optional: tmux (for deliberation monitoring)
• Optional: direnv (for environment management)

Quick Start

Recommended path:

npx --yes --package @dmsdc-ai/aigentry-devkit aigentry-devkit install

List profiles first:

npx --yes --package @dmsdc-ai/aigentry-devkit aigentry-devkit profiles

Install a specific profile:

npx --yes --package @dmsdc-ai/aigentry-devkit aigentry-devkit install --profile autoresearch-public

Use curator-public for dustcraw + brain + registry wiring, or ecosystem-full for the whole stack.

Force reinstall:

npx --yes --package @dmsdc-ai/aigentry-devkit aigentry-devkit install --force

Manual install (local clone) is still available:

macOS / Linux:

git clone https://github.com/dmsdc-ai/aigentry-devkit.git
cd aigentry-devkit
bash install.sh

Windows (PowerShell):

git clone https://github.com/dmsdc-ai/aigentry-devkit.git
cd aigentry-devkit
powershell -ExecutionPolicy Bypass -File .\install.ps1

The installer will:

1. Verify Node.js and optional dependencies (Claude Code CLI, tmux, direnv)
2. Install devkit assets, skills, HUD, and templates
3. Install and health-check local telepty
4. Install canonical deliberation MCP runtime
5. Optionally install brain
6. Optionally install and bootstrap dustcraw
7. Optionally wire registry credentials (AIGENTRY_API_URL, AIGENTRY_API_KEY)
8. Write local install state and env fan-out

Detailed walkthrough: docs/quickstart.md

Post-Installation

After installation, restart Claude/Codex/Gemini so MCP changes are picked up:

# Restart your CLI process to load new MCP settings

To verify installation:

npx --yes --package @dmsdc-ai/aigentry-devkit aigentry-devkit doctor
telepty --version
curl -sf http://localhost:3848/api/meta
npx --yes --package @dmsdc-ai/aigentry-deliberation deliberation-doctor
aigentry-brain health
dustcraw demo --non-interactive

If Gemini local MCP registration drifts:

npx --yes --package @dmsdc-ai/aigentry-devkit aigentry-devkit repair-gemini-mcp

Usage

Skills

Skills are automatically available in Claude Code, Codex CLI, and compatible MCP clients. They activate based on keywords:

Clipboard Image

Triggers: "clipboard", "paste image", "캡처 확인"

View and analyze images from your clipboard:

"Analyze this screenshot: [image in clipboard]"
"What's on my clipboard?"