My AI Agent

A CLI-based app for non-interactive (direct) inference from popular AI CLI tools such as Claude Code, Gemini CLI, Codex, OpenCode, etc. Simply run agent "your prompt here" and the app will figure out the best AI CLI agent tool automatically to return answers to your queries.

Features

- AI Tool Management: Add, edit, delete, view, list, and search tools
- Benchmarking: Test all tools to find the fastest one with performance tracking
- Unified Interface: Run any tool with a simple command
- Smart Selection: Automatically use the best-performing tool with intelligent fallback
- Configuration Management: Export/import tool configurations
- Tool State Control: Enable/disable tools for maintenance
- Markdown Rendering: Format AI responses with proper terminal display
- Interactive & Non-Interactive: Supports both modes for automation

Commands

| Command | Description | Usage |
|---------|-------------|-------|
| add | Add a new AI tool | agent add (interactive) or agent add --name tool --command "cmd" --description "desc" |
| edit | Edit an existing tool | agent edit or agent edit --tool-name --command "new cmd" |
| delete | Remove tools with confirmation | agent delete or agent delete --yes |
| view | Show detailed tool information | agent view |
| list | Display all tools with status | agent list |
| find | Search tools by name/description | agent find |
| check | Benchmark all tools | agent check or agent check --debug --include-disabled |
| run | Execute a specific tool | agent run "prompt" or agent run "prompt" --debug |
| export | Export configuration to JSON | agent export or agent export /path/to/config.json |
| import | Import configuration from JSON | agent import /path/to/config.json |
| enable | Enable a disabled tool | agent enable |
| disable | Disable a tool | agent disable |
| onboard | Display comprehensive guide | agent onboard |
| [prompt] | Run prompt with best tool | agent "your prompt", agent your prompt, agent --file ./path/to/file.txt or agent "prompt" --no-autocheck |

Installation

``bash
npm install -g my-ai-agent
`

Or use locally:

`bash
npm install
npm link
`

Add CLI Tools

Add one or more of these or your own custom tools with add command:

$3

- Name: codex
- Command: codex --yolo --model gpt-5.2 exec
- Description: OpenAI Codex

$3

- Name: claude
- Command: claude --dangerously-skip-permissions --no-chrome --model claude-sonnet-4-5 --output-format text -p
- Description: Claude Code

$3

- Name: opencode
- Command: opencode --model opencode/grok-code --format default run
- Description: OpenCode

$3

- Name: gemini
- Command: gemini -e none --model gemini-2.5-flash --yolo --output-format text
- Description: Gemini CLI

Tip: Replace gemini with qwen if you want that too.

Usage

$3

Interactive mode:
`bash
agent add
`

Non-interactive mode:
`bash
agent add --name mytool --command "mytool run" --description "My AI tool"
`

$3

`bash
agent list
`

$3

`bash
agent view
`

$3

Fuzzy search across tool names and descriptions:
`bash
agent find openai
`

$3

Interactive mode:
`bash
agent edit
`

Non-interactive mode:
`bash
agent edit --name "newname" --command "new command" --description "new desc"
agent edit --tool-name --description "updated description"
`

$3

Interactive mode (with confirmation):
`bash
agent delete
`

Non-interactive mode:
`bash
agent delete --yes
agent delete --tool-name --yes
`

$3

`bash
agent enable
agent disable
`

$3

Benchmark all tools and determine the best one:
`bash
agent check
`

With debug output to see each command being executed:
`bash
agent check --debug
`

Include disabled tools in benchmarking:
`bash
agent check --include-disabled
`

$3

`bash
agent run "your prompt here"
`

With debug output:
`bash
agent run "your prompt here" --debug


Shows: Debug: Executing command:

Then streams the tool output in real-time

`

$3

Use the best tool automatically with a direct prompt:
`bash
agent "tell me a joke"
`

or without quotes:

`bash
agent tell me a joke
`

Skip automatic fallback if best tool fails:
`bash
agent "tell me a joke" --no-autocheck
`

$3

You can also provide a file as input using the --file flag:

`bash
agent --file ./path/to/prompt.txt
`

This works with any text-based file (.txt, .md, .js, .py, etc.):

`bash
agent --file ./my-prompt.md
agent --file ./instructions.js
agent --file ./requirements.txt
`

The agent will read the file content and use it as the prompt for the AI tool.

You can also combine the file flag with other options:

`bash
agent --file ./prompt.txt --no-autocheck
`

$3

Get help with the --help option:

`bash
agent --help


or


agent -h
`

This will show all available commands and options, including the default usage for running prompts.

$3

Export configuration to a file:
`bash
agent export
agent export /path/to/config.json
`

Import configuration from a file:
`bash
agent import /path/to/config.json
`

$3

Display comprehensive onboarding information, useful for AI agents:
`bash
agent onboard
`

Configuration

Configuration is stored in a platform-specific location:
- Windows: %APPDATA%\my-ai-agent\config.json
- macOS/Linux: ~/.config/my-ai-agent/config.json

Development

$3

`bash
npm run build
`

$3

`bash
npm test
`

$3

`bash
npm run type-check
`

$3

`bash
npm run dev
``

Requirements

- Node.js >= 14.0.0

License

MIT