How-to Guides¶

Practical, step-by-step instructions for common tasks and workflows in GTB. These guides focus on the "How" – providing actionable steps to build and extend your CLI tools.

Development Workflows¶

Scaffolding a New CLI¶

Get up and running in seconds using the gtb CLI generator.

Configuring Built-in Features¶

How to toggle and tune framework features like Self-Updates, MCP, and AI documentation.

Adding Custom Commands¶

A hands-on guide to implementing domain-specific logic and registering it with the command tree.

Advanced Guides¶

Testing & Mocking¶

Strategies for unit testing your commands using the framework's built-in mocking capabilities.

AI Provider Setup¶

Choosing an AI provider (Claude, OpenAI, Gemini) and securely configuring your environment.

Adding an Initialiser¶

Learn how to create and register a custom Initialiser for your feature.