Install Commands CLI

A command-line interface for installing AI agent commands from the awesome-ai-commands repository.

Features

• Interactive selection of AI agents with multiselect and searchable interface
• Automatic creation of agent-specific folders
• Copying of command files to appropriate directories
• Bundling of commands with the CLI in the dist/ folder

Installation

1. Clone the repository:

   git clone https://github.com/your-username/awesome-ai-commands.git
   cd awesome-ai-commands

2. Install dependencies:

   cd apps/cli
   bun install

3. Build the CLI:

   bun run build

Usage

After building the CLI, you can run it using:

npx install-commands

Or if you've installed it globally:

install-commands

Interactive Prompt

When you run the CLI without any arguments, it will display an interactive prompt where you can:

• Select multiple AI agents from a searchable list
• Navigate using arrow keys
• Confirm your selection with Enter

Available AI Agents

The CLI supports the following AI agents:

• codex - OpenAI's Codex AI
• gemini - Google's Gemini AI
• opencode - OpenCode AI
• copilot - GitHub Copilot
• qwen - Alibaba's Qwen AI
• windsurf - Windsurf AI
• kilocode - Kilocode AI
• auggie - Auggie AI
• roo - Roo AI

How It Works

1. The CLI first copies all available commands from the commands/ directory to the dist/commands/ folder
2. It then creates individual folders for each selected AI agent within dist/commands/
3. The command files are bundled with the CLI, allowing it to find its own files and compute paths correctly
4. Finally, it lists all available commands that have been installed

Development

Project Structure

apps/cli/
├── cli.ts          # Main CLI implementation
├── build.ts        # Build script
├── package.json    # Package configuration
├── README.md       # This file
└── dist/           # Built output (generated after build)
    ├── cli.js      # Compiled CLI
    └── commands/   # Copied command files

Building the CLI

To build the CLI:

bun run build

This will:

1. Copy all commands from the root commands/ directory to dist/commands/
2. Compile cli.ts to JavaScript in the dist/ folder

Dependencies

• citty - Elegant CLI builder
• enquirer - Interactive command-line prompts
• bun - Package manager and build tool

Contributing

To contribute new commands or improve the CLI:

1. Fork the repository
2. Create your feature branch
3. Commit your changes
4. Push to the branch
5. Create a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.