Metadata-Version: 2.4
Name: hire-ai
Version: 0.1.2
Summary: CLI to orchestrate AI agents (Claude, Codex, Gemini)
Project-URL: Homepage, https://github.com/nichiki/hire-ai
Project-URL: Repository, https://github.com/nichiki/hire-ai
Project-URL: Issues, https://github.com/nichiki/hire-ai/issues
Author: nichiki
License-Expression: MIT
License-File: LICENSE
Keywords: agent,ai,claude,cli,codex,gemini,llm
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Provides-Extra: dev
Requires-Dist: build>=1.0; extra == 'dev'
Requires-Dist: mypy>=1.10; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff>=0.4; extra == 'dev'
Requires-Dist: twine>=5.0; extra == 'dev'
Description-Content-Type: text/markdown

# hire-ai

CLI to orchestrate AI agents (Claude, Codex, Gemini).

> **⚠️ Warning**: By default, all agents run in **auto-approve mode**:
> - Claude Code: `--dangerously-skip-permissions`
> - Codex: `--full-auto`
> - Gemini CLI: `-y`
>
> This means agents can execute commands and modify files without confirmation.
> You can customize this in `~/.config/hire/config.json`.

## Installation

```bash
# Using pipx (recommended)
pipx install hire-ai

# Using pip
pip install hire-ai

# Using Homebrew (macOS)
brew install nichiki/tap/hire-ai
```

## Prerequisites

You need at least one of the following CLI tools installed:

- [Claude Code](https://claude.ai/claude-code)
- [Codex](https://github.com/openai/codex)
- [Gemini CLI](https://github.com/google-gemini/gemini-cli)

## Usage

```bash
# Basic usage - hire an agent
hire codex "Design a REST API for a todo app"
hire gemini "Research the latest React 19 features"
hire claude "Review this code for security issues"

# Continue a session
hire -c codex "Tell me more about the authentication"
hire -s SESSION_ID "Follow up question"

# Name a session for later
hire -n my-project codex "Start designing the architecture"
hire -s my-project "What about the database schema?"

# Pipe input
cat main.py | hire codex "Review this code"
git diff | hire claude "Explain these changes"
echo "What is 2+2?" | hire gemini

# Attach files (using @filepath - agent feature)
hire claude "Review @src/main.py for security issues"
hire codex "Explain @package.json and @tsconfig.json"

# Output as JSON
hire gemini "Summarize this" --json

# Copy to clipboard
hire codex "Write a function" --clip

# Write to file
hire claude "Generate a README" -o README.md

# Session management
hire sessions              # List all sessions
hire sessions codex        # List Codex sessions only
hire show SESSION_ID       # Show session details
hire delete SESSION_ID     # Delete a session
```

## Options

| Option | Description |
|--------|-------------|
| `-c, --continue` | Continue the latest session |
| `-s, --session ID` | Continue a specific session |
| `-n, --name NAME` | Name the session |
| `-m, --model MODEL` | Specify model to use |
| `--json` | Output in JSON format |
| `--clip` | Copy output to clipboard |
| `-o, --out FILE` | Write output to file |

## Configuration

Config is stored at `~/.config/hire/config.json`:

```json
{
  "adapters": {
    "claude": {
      "command": "claude",
      "args": ["--dangerously-skip-permissions"]
    },
    "codex": {
      "command": "codex",
      "args": ["--full-auto"]
    },
    "gemini": {
      "command": "gemini",
      "args": ["-y"]
    }
  },
  "defaults": {
    "agent": "claude"
  }
}
```

## Data Storage

Sessions are stored at `~/.local/share/hire/sessions/`.

## License

MIT
