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