armandmcqueen/agentutils

Monorepo of small CLI tools designed for AI agents

★ 0Forks 0PythonGitHub ↗Compare

README

agentutils

A monorepo of small, focused CLI tools designed for AI agents. Each tool is independently installable via uv.

Tools

Tool Description
markdownpeek Structural explorer for Markdown files
gitro Read-only git wrapper for AI agents
lsrelated Find files frequently accessed together in Claude Code sessions
textplate Markdown templating — compose documents from reusable snippets via text:: links

Usage

Run any tool directly with uv:

uv run --directory tools/<name> <name> <args>

Every tool exposes self-describing commands:

# Full agent-oriented description
uv run --directory tools/<name> <name> tool-description

# Concise version suitable for CLAUDE.md
uv run --directory tools/<name> <name> tool-description-short

Development

Run tests for a specific tool:

uv run --directory tools/<name> pytest

Repo Layout

tools/     — Installable CLI tools (each has its own pyproject.toml)
libs/      — Shared libraries referenced as path dependencies

Contributors

armandmcqueen

Issues