OpenRouter CLI Agent

An AI coding assistant CLI powered by OpenRouter. This skill provides agentic capabilities with file system access, command execution, and smart context management through the OpenRouter platform.

What This Skill Does

This skill helps you set up and use the OpenRouter CLI tool, which provides:

Installation & Setup Instructions

Step 1: Install the OpenRouter CLI

First, install the OpenRouter CLI globally using npm:

```bash

npm install -g @tiendung-betapcode/openrouter-cli

```

Step 2: Authentication

**Recommended Method - Quick Login:**

1. Run the login command to authenticate via the web dashboard:

```bash

openrouter login

```

2. Follow the interactive prompts:

- Open the Dashboard URL displayed in the terminal

- Obtain your 8-character Access Code

- Paste the code back into the terminal

**Alternative Method - Manual API Key:**

If the login server is unavailable, create a `.env` file in your working directory:

```env

OPENROUTER_API_KEY=sk-or-v1-your-api-key-here

```

Get your API key from the OpenRouter dashboard at https://openrouter.ai/

Step 3: Start Using the CLI

Launch the OpenRouter CLI:

```bash

openrouter

```

You can now interact with the AI assistant directly in your terminal.

Available Commands

The OpenRouter CLI provides these built-in commands:

Usage Examples

**Example 1: Basic Coding Assistance**

```

User: Create a Python function to calculate Fibonacci numbers

AI: [Generates code with explanation]

```

**Example 2: File Operations**

```

User: Read the package.json file and explain its dependencies

AI: [Accesses file system, reads file, provides analysis]

```

**Example 3: Command Execution**

```

User: Run npm test and explain any failures

AI: [Executes command, analyzes output, provides insights]

```

**Example 4: Switching Models**

```

User: /model

AI: [Shows available models]

User: [Selects preferred model]

```

**Example 5: Saving Work**

```

User: /history

AI: [Saves conversation to Documents/openrouter/]

```

Important Notes

Architecture

The tool operates in a three-tier architecture:

1. **OpenRouter CLI** (local, installed via npm)

2. **API Server** (hosted on Vercel, handles requests)

3. **Firebase Backend** (stores API keys and history)

Troubleshooting

License

MIT © TIENDUNG