Skip to content

desplega-ai/ai-toolbox

Repository files navigation

AI Toolbox

Monorepo of AI and developer tools by desplega.ai. Each subdirectory is a standalone tool with its own README.

Repository Structure

Tool Description Stack
ai-tracker Track AI vs human code contributions Python, uv, SQLite
brain Personal knowledge management with semantic search TypeScript, Bun, SQLite
cc-hooks macOS notifications for Claude Code Bash
cc-notch Menu bar cost tracker (SwiftBar) Shell
cc-plugin Claude Code plugins YAML/Markdown
cc-what SDK & CLI for analyzing Claude Code usage data TypeScript, Bun
dokcli CLI tool for Dokploy (auto-generated from OpenAPI) TypeScript, Bun
dns DNS TXT record query utility -
file-review File review tool -
hive macOS app for Claude Code sessions TypeScript, Electron, Vite
hn-sql HN data with Parquet + SQL -
invoice-cli Invoice email fetcher -
thoughts Research notes & plans (via /desplega:*) Markdown
willitfront.page HN analysis with natural language -
wts Git worktree manager TypeScript, Bun

Thoughts

The thoughts directory contains research notes and implementation plans generated via Claude Code skills from the base plugin:

  • /desplega:research - Document codebase state with research notes
  • /desplega:create-plan - Create detailed implementation plans
  • /desplega:implement-plan - Execute plans from a plan file

Claude Plugins

Installation

From inside Claude Code:

/plugin marketplace add desplega-ai/ai-toolbox

Or from the terminal:

claude plugin marketplace add desplega-ai/ai-toolbox

Available Plugins

Plugin Description
desplega Base agentic coding patterns (research, planning, implementation)
agent-swarm Multi-agent coordination
wts Git worktree manager
brain Personal knowledge management integration
file-review File review with inline comments
remarkable reMarkable tablet integration (get, put, ls)
/plugin install desplega@desplega-ai-toolbox
/plugin install agent-swarm@desplega-ai-toolbox
/plugin install wts@desplega-ai-toolbox
/plugin install brain@desplega-ai-toolbox
/plugin install file-review@desplega-ai-toolbox
/plugin install remarkable@desplega-ai-toolbox

Bash Install

You can also install from the terminal:

# Scope can be 'user' (default), 'project' or 'local'
claude plugin install desplega@desplega-ai-toolbox --scope user
claude plugin install agent-swarm@desplega-ai-toolbox --scope user
claude plugin install wts@desplega-ai-toolbox --scope user
claude plugin install brain@desplega-ai-toolbox --scope user
claude plugin install file-review@desplega-ai-toolbox --scope user
claude plugin install remarkable@desplega-ai-toolbox --scope user

Plugin structure: cc-plugin/{base,swarm,wts,brain,file-review,remarkable}/ with hooks, skills, and agents.

Key Tools

ai-tracker (Python):

uvx cc-ai-tracker install   # Install hooks
uvx cc-ai-tracker stats     # View AI/human contribution stats

brain (TypeScript/Bun):

npm install -g @desplega.ai/brain
brain init && brain add "My first note"
brain search "ideas"        # Semantic search

cc-what (TypeScript/Bun):

npm install -g @desplega.ai/cc-what
cc-what                     # Summary of Claude Code usage
cc-what stats --daily       # Daily activity stats
cc-what costs --models      # Cost breakdown by model

wts (TypeScript/Bun):

npm install -g @desplega.ai/wts
wts init && wts create feature --new-branch

Development

Each tool is independent - check its README for specific setup. General pattern:

  • Python tools: uv or uvx
  • TypeScript tools: bun or pnpm
  • Plugins: YAML/Markdown configs in cc-plugin/

New tools: Create folder with minimal slug, add README.md.