amp-tool-creator

Custom Amp tools are created by placing executables in a tools directory and using the toolbox protocol to communicate via stdin and stdout. Tools must be registered with a tb__ prefix and provide tool descriptors for describe and execute operations.

Amp toolbox tools can be written in any programming language. The toolbox protocol uses simple stdin and stdout communication, so any executable that follows the describe and execute protocol can function as a valid tool.

Wrapping a CLI command for Amp involves creating a tool executable that follows the toolbox protocol and registers with the tb__ prefix. The wrapper communicates with Amp via stdin and stdout using describe and execute tool descriptors.

Skill-bundled Amp tools should be placed under the skill-name/tools directory. This location can also contain optional scripts, references, and assets directories to support the tool's execution within Amp workflows.

Amp discovers toolbox tools through the AMP_TOOLBOX environment variable, which controls the discovery process. This mechanism supports instruction-friendly integration with existing workflows for global, project-local, or skill-bundled tools.

No external dependencies are required to build Amp toolbox tools. You only need to create executables that follow the toolbox protocol for stdin and stdout communication and register them using the tb__ prefix convention.