hire-ai 0.1.0__tar.gz

hire_ai-0.1.0/.gitignore

@@ -0,0 +1,75 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# ruff
+.ruff_cache/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# macOS
+.DS_Store

hire_ai-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 nichiki
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

hire_ai-0.1.0/PKG-INFO

@@ -0,0 +1,125 @@
+Metadata-Version: 2.4
+Name: hire-ai
+Version: 0.1.0
+Summary: CLI to orchestrate AI agents (Claude, Codex, Gemini)
+Project-URL: Homepage, https://github.com/nichiki/hire
+Project-URL: Repository, https://github.com/nichiki/hire
+Project-URL: Issues, https://github.com/nichiki/hire/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.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development
+Classifier: Topic :: Utilities
+Requires-Python: >=3.11
+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
+
+CLI to orchestrate AI agents (Claude, Codex, Gemini).
+
+## Installation
+
+```bash
+# Using pipx (recommended)
+pipx install hire
+
+# Using pip
+pip install hire
+
+# Using Homebrew
+brew install nichiki/tap/hire
+```
+
+## Prerequisites
+
+You need at least one of the following CLI tools installed:
+
+- [Claude CLI](https://docs.anthropic.com/claude-code)
+- [Codex CLI](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?"
+
+# Output as JSON
+hire gemini "Summarize this" --json
+
+# 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 |
+
+## 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

hire_ai-0.1.0/README.md

@@ -0,0 +1,94 @@
+# hire
+
+CLI to orchestrate AI agents (Claude, Codex, Gemini).
+
+## Installation
+
+```bash
+# Using pipx (recommended)
+pipx install hire
+
+# Using pip
+pip install hire
+
+# Using Homebrew
+brew install nichiki/tap/hire
+```
+
+## Prerequisites
+
+You need at least one of the following CLI tools installed:
+
+- [Claude CLI](https://docs.anthropic.com/claude-code)
+- [Codex CLI](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?"
+
+# Output as JSON
+hire gemini "Summarize this" --json
+
+# 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 |
+
+## 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

hire_ai-0.1.0/hire/__init__.py

@@ -0,0 +1,3 @@
+"""hire - CLI to orchestrate AI agents (Claude, Codex, Gemini)."""
+
+__version__ = "0.1.0"

hire_ai-0.1.0/hire/adapters/__init__.py

@@ -0,0 +1,21 @@
+"""Agent adapters."""
+
+from .base import AgentAdapter
+from .claude import ClaudeAdapter
+from .codex import CodexAdapter
+from .gemini import GeminiAdapter
+
+
+def get_adapter(agent: str) -> AgentAdapter:
+    """Get an adapter for the specified agent."""
+    adapters = {
+        "claude": ClaudeAdapter,
+        "codex": CodexAdapter,
+        "gemini": GeminiAdapter,
+    }
+    if agent not in adapters:
+        raise ValueError(f"Unknown agent: {agent}. Available: {list(adapters.keys())}")
+    return adapters[agent]()
+
+
+__all__ = ["AgentAdapter", "ClaudeAdapter", "CodexAdapter", "GeminiAdapter", "get_adapter"]

hire_ai-0.1.0/hire/adapters/base.py

@@ -0,0 +1,42 @@
+"""Base adapter class."""
+
+from abc import ABC, abstractmethod
+from typing import Any
+
+
+class AgentAdapter(ABC):
+    """Abstract base class for agent adapters."""
+
+    name: str = "base"
+
+    @abstractmethod
+    def ask(
+        self,
+        message: str,
+        session_id: str | None = None,
+        model: str | None = None,
+    ) -> dict[str, Any]:
+        """
+        Send a message to the agent and get a response.
+
+        Args:
+            message: The message to send
+            session_id: Optional CLI session ID for continuation
+            model: Optional model to use
+
+        Returns:
+            dict with keys:
+                - response: The agent's response text
+                - session_id: The CLI session ID for future continuation
+                - raw: The raw output from the CLI (for debugging)
+        """
+        pass
+
+    def build_command(
+        self,
+        message: str,
+        session_id: str | None = None,
+        model: str | None = None,
+    ) -> list[str]:
+        """Build the command to execute. Override in subclasses."""
+        raise NotImplementedError

hire_ai-0.1.0/hire/adapters/claude.py

@@ -0,0 +1,74 @@
+"""Claude CLI adapter."""
+
+import json
+import subprocess
+from typing import Any
+
+from ..config import get_adapter_config
+from .base import AgentAdapter
+
+
+class ClaudeAdapter(AgentAdapter):
+    """Adapter for Claude CLI."""
+
+    name = "claude"
+
+    def build_command(
+        self,
+        message: str,
+        session_id: str | None = None,
+        model: str | None = None,
+    ) -> list[str]:
+        """Build the claude command."""
+        config = get_adapter_config("claude")
+        command = config.get("command", "claude")
+        args = config.get("args", [])
+
+        cmd = [command, "-p", message, "--output-format", "json"]
+        cmd.extend(args)
+
+        if session_id:
+            cmd.extend(["--resume", session_id])
+
+        if model:
+            cmd.extend(["--model", model])
+
+        return cmd
+
+    def ask(
+        self,
+        message: str,
+        session_id: str | None = None,
+        model: str | None = None,
+    ) -> dict[str, Any]:
+        """Send a message to Claude and get a response."""
+        cmd = self.build_command(message, session_id, model)
+
+        result = subprocess.run(
+            cmd,
+            capture_output=True,
+            text=True,
+        )
+
+        if result.returncode != 0:
+            return {
+                "response": None,
+                "session_id": session_id,
+                "error": result.stderr or "Command failed",
+                "raw": result.stdout,
+            }
+
+        try:
+            data = json.loads(result.stdout)
+            return {
+                "response": data.get("result", ""),
+                "session_id": data.get("session_id", session_id),
+                "raw": data,
+            }
+        except json.JSONDecodeError:
+            # If not JSON, return raw output
+            return {
+                "response": result.stdout,
+                "session_id": session_id,
+                "raw": result.stdout,
+            }

hire_ai-0.1.0/hire/adapters/codex.py

@@ -0,0 +1,98 @@
+"""Codex CLI adapter."""
+
+import json
+import subprocess
+from typing import Any
+
+from ..config import get_adapter_config
+from .base import AgentAdapter
+
+
+class CodexAdapter(AgentAdapter):
+    """Adapter for Codex CLI."""
+
+    name = "codex"
+
+    def build_command(
+        self,
+        message: str,
+        session_id: str | None = None,
+        model: str | None = None,
+    ) -> list[str]:
+        """Build the codex command."""
+        config = get_adapter_config("codex")
+        command = config.get("command", "codex")
+        args = config.get("args", [])
+
+        if session_id:
+            # Resume session: codex exec resume <SESSION_ID> "message"
+            cmd = [command, "exec", "resume", session_id, message, "--json", "--skip-git-repo-check"]
+        else:
+            # New session: codex exec "message"
+            cmd = [command, "exec", message, "--json", "--skip-git-repo-check"]
+
+        cmd.extend(args)
+
+        if model:
+            cmd.extend(["--model", model])
+
+        return cmd
+
+    def ask(
+        self,
+        message: str,
+        session_id: str | None = None,
+        model: str | None = None,
+    ) -> dict[str, Any]:
+        """Send a message to Codex and get a response."""
+        cmd = self.build_command(message, session_id, model)
+
+        result = subprocess.run(
+            cmd,
+            capture_output=True,
+            text=True,
+        )
+
+        if result.returncode != 0:
+            return {
+                "response": None,
+                "session_id": session_id,
+                "error": result.stderr or "Command failed",
+                "raw": result.stdout,
+            }
+
+        # Codex outputs JSONL (one JSON object per line)
+        # Parse all lines and extract the final response
+        lines = result.stdout.strip().split("\n")
+        response_text = ""
+        new_session_id = session_id
+
+        for line in lines:
+            if not line.strip():
+                continue
+            try:
+                event = json.loads(line)
+                event_type = event.get("type", "")
+
+                # Get thread_id from thread.started event
+                if event_type == "thread.started":
+                    new_session_id = event.get("thread_id", new_session_id)
+
+                # Get response text from item.completed with agent_message
+                if event_type == "item.completed":
+                    item = event.get("item", {})
+                    if item.get("type") == "agent_message":
+                        response_text = item.get("text", "")
+
+            except json.JSONDecodeError:
+                continue
+
+        # If no structured response found, use raw output
+        if not response_text:
+            response_text = result.stdout.strip()
+
+        return {
+            "response": response_text,
+            "session_id": new_session_id,
+            "raw": result.stdout,
+        }

hire_ai-0.1.0/hire/adapters/gemini.py

@@ -0,0 +1,91 @@
+"""Gemini CLI adapter."""
+
+import json
+import subprocess
+from typing import Any
+
+from ..config import get_adapter_config
+from .base import AgentAdapter
+
+
+class GeminiAdapter(AgentAdapter):
+    """Adapter for Gemini CLI."""
+
+    name = "gemini"
+
+    def build_command(
+        self,
+        message: str,
+        session_id: str | None = None,
+        model: str | None = None,
+    ) -> list[str]:
+        """Build the gemini command."""
+        config = get_adapter_config("gemini")
+        command = config.get("command", "gemini")
+        args = config.get("args", [])
+
+        # gemini -p "message" -o json -y
+        cmd = [command, "-p", message, "-o", "json"]
+        cmd.extend(args)
+
+        # Resume uses "latest" or index number, not session ID
+        if session_id:
+            cmd.extend(["-r", session_id])
+
+        if model:
+            cmd.extend(["-m", model])
+
+        return cmd
+
+    def ask(
+        self,
+        message: str,
+        session_id: str | None = None,
+        model: str | None = None,
+    ) -> dict[str, Any]:
+        """Send a message to Gemini and get a response."""
+        cmd = self.build_command(message, session_id, model)
+
+        result = subprocess.run(
+            cmd,
+            capture_output=True,
+            text=True,
+        )
+
+        if result.returncode != 0:
+            return {
+                "response": None,
+                "session_id": session_id,
+                "error": result.stderr or "Command failed",
+                "raw": result.stdout,
+            }
+
+        # Try to parse JSON output
+        try:
+            data = json.loads(result.stdout)
+            # Extract response - structure may vary
+            response_text = ""
+            new_session_id = session_id
+
+            if isinstance(data, dict):
+                response_text = data.get("result", data.get("response", data.get("text", "")))
+                new_session_id = data.get("session_id", data.get("sessionId", session_id))
+            elif isinstance(data, str):
+                response_text = data
+
+            # For continuation, use "latest" as session identifier
+            if not new_session_id:
+                new_session_id = "latest"
+
+            return {
+                "response": response_text,
+                "session_id": new_session_id,
+                "raw": data,
+            }
+        except json.JSONDecodeError:
+            # Plain text output
+            return {
+                "response": result.stdout.strip(),
+                "session_id": "latest",  # Use "latest" for continuation
+                "raw": result.stdout,
+            }