GerdsenAI/GerdsenAI-Agentic-Devtools

# GerdsenAI Agentic Devtools It runs natively in Claude Code via `/gerdsenai:` slash commands and is powered by the [GerdsenAI Document Builder](https://github.com/GerdsenAI/GerdsenAI_Document_Builder). ## Table of Contents - [Quick start](#quick-start) - [Commands](#commands) - [Use from any AI tool](#use-from-any-ai-tool) - [Local inference](#local-inference) - [Configuration](#configuration) - [Design-driven planning](#design-driven-planning) - [Documentation](#documentation) - [About Gerdsen.AI](#about-gerdsenai) - [License](#license) - [Disclaimer](#disclaimer) ## Quick start **Prerequisite:** [uv](https://docs.astral.sh/uv/). The plugin is uv-native — uv creates the virtual environment and provisions a suitable Python (3.9+) itself, so a separate Python install is not required. On Windows, also install Git for Windows (provides Git Bash). # Install uv (macOS/Linux) curl -LsSf https://astral.sh/uv/install.sh | sh **Install the plugin** — either point Claude Code at a local checkout: claude --plugin-dir . …or add the marketplace from inside Claude Code: run `/plugin`, open **Marketplaces**, add `GerdsenAI/GerdsenAI-Agentic-Devtools`, then install **gerdsenai** from **Discover** and run `/reload-plugins`. **Configure and build:** /gerdsenai:setup # guided install + preferences (output, logos, page size, vector DB) /gerdsenai:build my-doc.md # build a professional PDF See [docs/USAGE.md](docs/USAGE.md) for full install methods, troubleshooting, and detailed configuration. ## Commands | Command | Description | |---------|-------------| | `/gerdsenai:setup` | Install, configure, or update the Document Builder | | `/gerdsenai:build ` | Build PDFs — single file or recursive directory (auto-detected) | | `/gerdsenai:research-report [topic\|file]` | Deep multi-source research and intelligence reports; source-freshness monitoring when given a report file | | `/gerdsenai:red-team ` | Adversarial analysis across 11 domains (code, security, deps, architecture, testing, DevOps, DB, AI/ML, accessibility, docs, strategic) | | `/gerdsenai:vector-db [operation]` | Vector DB management: report, store, query, sync, configure — ChromaDB, Pinecone, or Qdrant (local FastEmbed or server/Cloud). Detect-and-reuse onboarding, project-aware model recommendation, local-LLM embeddings, dual-backend auto-mirror, and local↔cloud sync | | `/gerdsenai:sprint-execute [plan\|description\|resume]` | Autonomous sprint executor: Socratic planning, autocoding, auto-commit | | `/gerdsenai:llm [detect\|configure\|test\|run]` | Configure or use a local/remote OpenAI-compatible LLM backend | | `/gerdsenai:init [target-dir]` | Scaffold a new cross-platform, agent-ready project (AGENTS.md, MCP, CLAUDE.md, local-inference config, git init) | | `/gerdsenai:agentic-ui --phase 1\|2\|3` | Scaffold a standalone agent-observability web app — a deliverable that lets anyone watch an AI agent work | | `/gerdsenai:design-plan` | Print a curated starter prompt for `/ultraplan` (cloud planning, browser review) so a design refresh of the plugin's customer surface is driven by Anthropic's `frontend-design` skill | `/gerdsenai:agentic-ui` generates a standalone Node + Docker Compose app (not a UI for this plugin) in three cumulative phases: a live in-browser **terminal** (xterm.js + node-pty), a Dockerized **pseudo-desktop** (Xvfb + x11vnc + noVNC), and a **computer-use** loop (screenshot → VLM → click/type). It is public-safe and BYO-model — it ships no credentials or hardcoded endpoints, binds `127.0.0.1` behind a generated auth token, and defaults to read-only; you supply your own vision model. A `pdf-document-authoring` skill activates automatically when you write Markdown intended for PDF, guiding front matter, heading hierarchy, code blocks, and Mermaid diagrams. Full command options, agent workflows, and report types are documented in [docs/USAGE.md](docs/USAGE.md). ## Use from any AI tool The toolkit is not Claude-only. It ships an **MCP server** and an **`AGENTS.md`** so the same capabilities are available to Codex, GitHub Copilot, VS Code, Cursor, Gemini CLI, OpenCode, and other agents. Your host agent does the reasoning; the repo provides portable scripts that wrap the PDF renderer, vector memory, source tracking, and local-inference layer. - **MCP server** exposes tools such as `build_pdf`, `vector_db_query`, `vector_db_store`, `track_sources`, and `llm_complete`. - **`AGENTS.md`** is read natively by Codex, Cursor, Gemini CLI, and OpenCode; a Copilot instructions file covers GitHub Copilot. See [docs/CROSS-PLATFORM.md](docs/CROSS-PLATFORM.md) for the full client matrix and registration steps. ## Local inference AI features can route to any OpenAI-compatible `/v1` endpoint, so models served locally work without a hosted API. Backends (Ollama, vLLM, LM Studio) are auto-detected. /gerdsenai:llm detect # probe running backends See [docs/LOCAL-INFERENCE.md](docs/LOCAL-INFERENCE.md) for backends, configuration, and environment variables. ## Configuration After `/gerdsenai:setup`, settings are stored either **per-repo** at `.claude/gerdsenai.local.md` or **globally** at `~/.claude/gerdsenai.global.md` (you choose the scope; a per-repo file takes precedence). Key fields cover the Document Builder path, vector DB mode, output location, logos, page size, and citation style. Edit settings interactively with `/gerdsenai:setup` (choose "Configure settings"). The full settings reference and Document Builder `config.yaml` styling options are in [docs/USAGE.md](docs/USAGE.md). ## Design-driven planning For releases that are primarily about *how the plugin looks and feels* (templates, scaffolder copy, README, marketplace listing), use `/gerdsenai:design-plan` to print a curated starter prompt and paste it into Claude Code's [`/ultraplan`](https://code.claude.com/docs/en/ultraplan) (research preview; v2.1.91+) — the planning task moves to a cloud Claude Code session that you review in your browser (inline comments, emoji approvals, structured outline). This repo's `.claude/settings.json` enables Anthropic's [`frontend-design`](https://github.com/anthropics/claude-plugins-public/tree/main/plugins/frontend-design) plugin per-repo so the cloud session inherits its bold aesthetic POV (typography, color, motion, composition — explicitly anti-"AI slop"). Install it once on your machine with `claude plugin install frontend-design`. Approve the plan in the browser, then execute the v1.4.0 design refresh locally on a `feat/*` branch. Full workflow: [skills/agentic-ui/references/design-ultraplan.md](skills/agentic-ui/references/design-ultraplan.md). ## Documentation - [docs/USAGE.md](docs/USAGE.md) — install methods, command options, agent workflows, configuration reference, troubleshooting - [docs/CROSS-PLATFORM.md](docs/CROSS-PLATFORM.md) — using the toolkit from any AI tool (MCP + AGENTS.md) - [docs/LOCAL-INFERENCE.md](docs/LOCAL-INFERENCE.md) — Ollama / vLLM / LM Studio configuration - [docs/OPTIMIZATION.md](docs/OPTIMIZATION.md) — performance and resource tuning - [CHANGELOG.md](CHANGELOG.md) — release history ## About Gerdsen.AI GerdsenAI Agentic Devtools is built and maintained by [Gerdsen.AI](https://gerdsen.ai), which designs practical, cross-platform tooling that helps teams put AI agents to work — from document generation to research, code review, and autonomous engineering. Learn more at [gerdsen.ai](https://gerdsen.ai). ## License MIT License — see [LICENSE](LICENSE). ## Disclaimer This software is provided **"AS IS"**, without warranty of any kind. AI-generated output (documents, research, code, reviews) may be inaccurate or incomplete — **always verify before relying on it**. Nothing produced by this toolkit constitutes legal, financial, or other professional advice, and you are responsible for the content you generate and how you use it. See [DISCLAIMER.md](DISCLAIMER.md) for full terms.