Frequently Asked Questions
Everything you need to know about cli4ai
Is cli4ai really free?
Yes! cli4ai is completely free and open source. Install unlimited packages, use all CLI features, and build your own tools at no cost.
What AI assistants does cli4ai work with?
cli4ai works with any AI assistant that can run terminal commands. It also supports MCP (Model Context Protocol) for deeper integration with Claude Desktop, Cursor, and other MCP-compatible tools.
Do I need to configure MCP to use cli4ai?
No! The simplest approach is to document your tools in CLAUDE.md or AGENTS.md and let your AI assistant use them via terminal commands. MCP configuration is optional for deeper integration.
How do I create my own package?
Run `cli4ai init my-tool` to scaffold a new package. Add your commands to cli4ai.json and implement them in run.ts. See the Creating Packages guide for details.
Where are packages installed?
Global packages go to ~/.cli4ai/packages/. Local (project-specific) packages go to ./.cli4ai/packages/. Use `cli4ai add -g` for global or `cli4ai add` for local installs.
How do I store API keys securely?
Use `cli4ai secrets set API_KEY` to store credentials in an encrypted vault. Secrets are automatically injected when running tools that need them.
Can I contribute packages to the registry?
Yes! cli4ai is open source. Fork the packages repo, create your package, and submit a pull request. Community contributions are welcome.
What runtimes are supported?
Packages can use Bun (default), Node.js, or Deno. Specify your runtime in cli4ai.json. Bun is recommended for best performance.
Ready to supercharge your
AI agent?
Start with our free tier. Install unlimited packages. Upgrade when you need more power and collaboration features.