Files
temp/docs/showcase/cli-tools
HAL9000 ccfbf11009 docs: add showcase example for server and A2A integration
Adds a complete end-to-end walkthrough of the server connection CLI
commands and A2A protocol facade, verified by the UAT system with real
command outputs. Covers:

- agents server --help, connect, status, serve commands
- All output formats (rich, json, yaml, plain)
- A2A JSON-RPC 2.0 wire format (A2aRequest, A2aResponse, A2aEvent)
- A2aLocalFacade: 42 supported operations, stub mode, service wiring
- get_facade() wired to real DI container
- A2aVersionNegotiator: version negotiation and mismatch handling
- ServerConnectionConfig: validation rules

Also updates examples.json index with the new entry.
2026-04-07 14:54:49 +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.