climpt-agent

Climpt

English | 日本語

CLI Prompt Management Tool. Agents: Iterator, Reviewer also included. Besides CLI, it is available through MCP and plugins. The plugin skills run on a dedicated climpt-agent (via the Claude Agent SDK).

Quick Start

# Initialize configuration
deno run -A jsr:@aidevtool/climpt init

# Upgrade to latest version and update docs
deno run -Ar jsr:@aidevtool/climpt upgrade

# Run your first command
echo "Fix login bug" | deno run -A jsr:@aidevtool/climpt git decide-branch working-branch

📖 Full Documentation

What is Climpt?

Climpt organizes pre-configured prompts and invokes them with a single command. Three ways to use:

Method	Description
CLI	Direct command-line execution
MCP	Integration with Claude/Cursor via Model Context Protocol
Plugin	Claude Code plugin with climpt-agent

Learn More

Explore interactively: Climpt NotebookLM

CLI Usage

Command Syntax

deno run -A jsr:@aidevtool/climpt <profile> <directive> <layer> [options]

Example:

# Break down issue into tasks
deno run -A jsr:@aidevtool/climpt breakdown to task --from=issue.md --adaptation=detailed

# Generate from stdin
echo "error log" | deno run -A jsr:@aidevtool/climpt diagnose trace stack -o=./output/

Key Options

Option	Short	Description
--from	-f	Input file
--destination	-o	Output path
--edition	-e	Prompt edition
--adaptation	-a	Prompt variation
--uv-*	-	Custom variables

📖 Full CLI Reference

Prompt Templates

Prompts are organized in .agent/climpt/prompts/:

.agent/climpt/prompts/<profile>/<directive>/<layer>/f_<edition>_<adaptation>.md

Template Variables:

• {input_text} - Text from stdin
• {input_text_file} - Input file path
• {destination_path} - Output path
• {uv-*} - Custom variables

📖 Prompt Guide

MCP Server

Integrate with Claude or Cursor via MCP:

{
  "mcpServers": {
    "climpt": {
      "command": "deno",
      "args": ["run", "-A", "jsr:@aidevtool/climpt/mcp"]
    }
  }
}

📖 MCP Configuration Guide

Claude Code Plugin

# Add marketplace
/plugin marketplace add tettuan/climpt

# Install
/plugin install climpt-agent

Features:

• Natural language command execution
• Git workflows (commit, branch, PR)
• Prompt management operations

Agents

Prerequisites: Agents require GitHub CLI (gh) installed and authenticated, plus a Git repository pushed to GitHub.

Agent Structure

Each agent is defined in .agent/{agent-name}/ with:

.agent/{agent-name}/
├── agent.json          # Agent configuration
├── steps_registry.json # Step definitions for prompts
└── prompts/            # Prompt templates
    └── system.md       # System prompt

agent.json key properties:

• name, displayName, version - Agent identification
• runner.verdict.type - Execution mode (see below)
• runner.boundaries.allowedTools - Available tools for the agent
• runner.flow.prompts.registry - Path to steps registry
• runner.logging.directory - Log output location

steps_registry.json defines prompt selection logic for each execution step.

Creating a New Agent

deno task agent --init --agent {agent-name}

This generates the directory structure with template files.

Builder Documentation: For detailed guides on agent configuration and customization, see agents/docs/builder/.

Running Agents

# List available agents
deno task agent --list

# Run with GitHub Issue
deno task agent --agent {name} --issue {number}

# Run in iterate mode
deno task agent --agent {name} --iterate-max 10

Verdict Types