Toolpack CLI

The intelligent command-line interface directly powering the Toolpack SDK.

Bring the power of multi-provider AI agents, dynamic tools, and autonomous workflows directly to your terminal.

Overview

The toolpack-cli is an interactive, terminal-based user interface (TUI) designed to demonstrate the capabilities of the Toolpack SDK. It provides a highly polished, React/Ink-powered chat experience inside your terminal, allowing you to fluidly interact with multiple AI providers (OpenAI, Anthropic, Gemini, Ollama) and trigger dozens of built-in system file operations without leaving the command line.

Installation

Install globally via npm to use the toolpack command anywhere:

npm i -g toolpack-cli

Or run via npx without installing:

npx toolpack-cli

Quick Start

Run the application:

toolpack

(Note: For cloud providers like OpenAI, Anthropic, or Gemini, set the relevant environment variables—e.g., TOOLPACK_OPENAI_KEY, TOOLPACK_ANTHROPIC_KEY, TOOLPACK_GEMINI_KEY—in your shell before running toolpack.)

Features & Commands

The CLI supports a robust set of slash (/) commands entered directly into the chat input to manage context, tools, and models dynamically.

Core Commands

Command	Description
/help	Display the help menu with all available slash commands.
/clear	Clear the current conversation history and reset the session.
/info	Display current SDK configuration, session memory usage, and backend stats.
/version	Show the currently installed version of the CLI and SDK.

Configuration Commands

Command	Description
/mode [mode_name]	Switch the active AI mode (e.g., chat, architect, code). Leave empty to view current.
/model [model_name]	Switch the active AI model/provider. Leave empty to view current.

Tool Commands

Command	Description
/tools	List all available built-in tools (File system, Web search, System execution, etc).
/tool-search [query]	Search the tool registry by name or capability description to find the right tool.
/tool-log	Preview the execution logs and outputs of all tools triggered during the current session.

Advanced Configuration

You can fully customize the behavior of the SDK and this CLI by placing a toolpack.config.json in the root of your project territory. (The CLI will automatically discover it).

Example Configuration:

{
	"fastAIModels": {
		"openai": "gpt-4o-mini",
		"anthropic": "claude-3-haiku-20240307"
	},
	"ollama": {
		"baseUrl": "http://localhost:11434"
	},
	"tools": {
		"enabled": true,
		"toolChoicePolicy": "required_for_actions",
		"toolSearch": {
			"enabled": true,
			"searchResultLimit": 5
		}
	}
}

Related

• Toolpack SDK - The foundational TypeScript SDK library behind this product.

---

Status

Current Version: 0.1.0

• ✓ Multi-Provider Support — See supported providers in the SDK
• ✓ Built-in Tools — See all tools in the SDK
• ✓ Mode System — See modes in the SDK
• ✓ Workflow Engine — Execute complex AI-driven plans and parallel steps interactively
• ✓ BM25 Search — On-demand tool discovery for large agentic libraries directly in the chat

Custom Tools (CLI-specific)

The CLI includes additional tools not in the base SDK:

Tool	Description
skill.create	Create a new skill file in .skills/
skill.list	List all available skills
skill.read	Read a skill file content
skill.search	Search skills by name or description
skill.update	Update an existing skill

Contributing

Contributions welcome! Please read the contributing guide first to get started with local development.

License

Apache 2.0 © Sajeer

Support

• 🐛 Issue Tracker (Please use our Bug Report or Feature Request templates)
• 💬 Discussions