Files
temp/docs/showcase/cli-tools
HAL9000 07f9364bcb docs: add showcase example for database migration management
Adds a complete end-to-end walkthrough of the `agents db` command group,
verified by the UAT system with real command outputs. Covers:

- agents db --help (command discovery)
- agents db current (fresh database: 41 pending migrations listed)
- agents db history (full 41-revision DAG with branchpoints/mergepoints)
- agents db history --format json (structured DAG for scripting)
- agents db upgrade (applying all 41 migrations to head)
- agents db current --format json (CI/CD integration pattern)
- agents db downgrade -- -1 (relative rollback with -- separator)
- agents db downgrade <revision-id> (targeted rollback)
- agents db upgrade <revision-id> (targeted upgrade)
- agents db upgrade --format json (idempotent upgrade with JSON output)

Also updates examples.json index with the new entry.
2026-04-07 14:53:12 +00:00
..

CLI Tools Examples

This directory contains examples of command-line tools built with CleverAgents. These examples demonstrate how to create practical text-based applications that developers use every day.

What You'll Find Here

  • Todo Applications: Task management tools with add, list, complete functionality
  • File Organizers: Tools to sort and manage files based on various criteria
  • Text Processors: Utilities for formatting, converting, or analyzing text
  • Project Scaffolders: Tools that generate boilerplate code and project structures
  • Developer Utilities: Various helper tools for common development tasks

Example Categories

All examples in this directory:

  • Are fully text-based (no GUI required)
  • Can be run from the command line
  • Produce clear, useful output
  • Demonstrate CleverAgents' ability to build real tools

Getting Started

  1. Browse the examples in this directory
  2. Pick one that matches your interest
  3. Follow the step-by-step walkthrough
  4. Modify and extend to create your own version

Examples in this directory are automatically generated from successful UAT test runs.