heru 0.0.1__tar.gz

heru-0.0.1/.github/workflows/test.yml

@@ -0,0 +1,18 @@
+name: Tests
+
+on: [push, pull_request]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: pip install uv
+      - run: uv sync
+      - run: uv run pytest

heru-0.0.1/.gitignore

@@ -0,0 +1,28 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+.pytest_cache/
+.coverage
+htmlcov/
+.vscode/
+.idea/
+.venv/
+uv.lock

heru-0.0.1/.python-version

@@ -0,0 +1 @@
+3.13

heru-0.0.1/Makefile

@@ -0,0 +1,25 @@
+.PHONY: test setup shell coverage publish-build publish-test publish publish-clean
+
+test:
+	uv run pytest
+
+setup:
+	uv sync --dev
+
+shell:
+	uv shell
+
+coverage:
+	uv run pytest --cov=heru --cov-report=term-missing
+
+publish-build:
+	uv run hatch build
+
+publish-test:
+	uv run hatch publish --repo test
+
+publish:
+	uv run hatch publish
+
+publish-clean:
+	rm -r dist/

heru-0.0.1/PKG-INFO

@@ -0,0 +1,53 @@
+Metadata-Version: 2.4
+Name: heru
+Version: 0.0.1
+Summary: Unified CLI for AI coding agents. One command, any engine.
+Project-URL: Homepage, https://github.com/alexeygrigorev/heru
+Project-URL: Repository, https://github.com/alexeygrigorev/heru
+Author-email: Alexey Grigorev <alexey@grigorev.name>
+License: MIT
+Keywords: agents,ai,claude,cli,codex,coding,copilot
+Classifier: Development Status :: 1 - Planning
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+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
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# heru
+
+Unified CLI for AI coding agents. One command, any engine.
+
+```bash
+heru "implement auth" --engine claude --model claude-opus-4-6
+heru "fix the bug" --engine codex --model gpt-5.4-high
+heru --continue abc-123 "add tests"
+heru "write docs"
+```
+
+Supports: codex, claude, copilot, gemini, opencode, goz.
+
+All engines output the same normalized JSONL event format, regardless of which engine runs underneath.
+
+## Install
+
+```bash
+pip install heru
+```
+
+## Usage
+
+```bash
+heru "your prompt here"                          # uses default engine
+heru "your prompt" --engine claude                # specify engine
+heru "your prompt" --engine codex --model o3      # specify engine and model
+heru --continue <session-id> "continue working"   # resume a session
+```
+
+## Part of litehive
+
+heru is the engine layer for [litehive](https://github.com/alexeygrigorev/litehive), an autonomous task execution system for software projects.

heru-0.0.1/README.md

@@ -0,0 +1,33 @@
+# heru
+
+Unified CLI for AI coding agents. One command, any engine.
+
+```bash
+heru "implement auth" --engine claude --model claude-opus-4-6
+heru "fix the bug" --engine codex --model gpt-5.4-high
+heru --continue abc-123 "add tests"
+heru "write docs"
+```
+
+Supports: codex, claude, copilot, gemini, opencode, goz.
+
+All engines output the same normalized JSONL event format, regardless of which engine runs underneath.
+
+## Install
+
+```bash
+pip install heru
+```
+
+## Usage
+
+```bash
+heru "your prompt here"                          # uses default engine
+heru "your prompt" --engine claude                # specify engine
+heru "your prompt" --engine codex --model o3      # specify engine and model
+heru --continue <session-id> "continue working"   # resume a session
+```
+
+## Part of litehive
+
+heru is the engine layer for [litehive](https://github.com/alexeygrigorev/litehive), an autonomous task execution system for software projects.

heru-0.0.1/heru/__init__.py

@@ -0,0 +1,5 @@
+"""heru - Unified CLI for AI coding agents. One command, any engine."""
+
+from heru.__version__ import __version__
+
+__all__ = ["__version__"]

heru-0.0.1/heru/__version__.py

@@ -0,0 +1 @@
+__version__ = "0.0.1"

heru-0.0.1/heru/cli.py

@@ -0,0 +1,28 @@
+"""heru CLI - Unified interface for AI coding agents."""
+
+import argparse
+
+from heru.__version__ import __version__
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="Unified CLI for AI coding agents. One command, any engine.",
+    )
+    parser.add_argument("prompt", nargs="?", help="The prompt to send to the agent")
+    parser.add_argument("--engine", help="Engine to use (codex, claude, copilot, gemini, opencode, goz)")
+    parser.add_argument("--model", help="Model override for the engine")
+    parser.add_argument("--continue", dest="continue_session", metavar="SESSION_ID", help="Resume a previous session")
+    parser.add_argument("--version", "-v", action="version", version=f"heru {__version__}")
+    args = parser.parse_args()
+
+    if not args.prompt and not args.continue_session:
+        parser.print_help()
+        return 1
+
+    print(f"heru v{__version__} - coming soon")
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

heru-0.0.1/pyproject.toml

@@ -0,0 +1,57 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "heru"
+description = "Unified CLI for AI coding agents. One command, any engine."
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.10"
+dynamic = ["version"]
+
+dependencies = []
+
+authors = [
+    {name = "Alexey Grigorev", email = "alexey@grigorev.name"}
+]
+
+keywords = ["ai", "coding", "agents", "cli", "codex", "claude", "copilot"]
+classifiers = [
+    "Development Status :: 1 - Planning",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+]
+
+[project.scripts]
+heru = "heru.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/alexeygrigorev/heru"
+Repository = "https://github.com/alexeygrigorev/heru"
+
+[dependency-groups]
+dev = [
+    "hatch",
+    "pytest",
+    "pytest-cov",
+    "ruff",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["heru"]
+
+[tool.hatch.version]
+path = "heru/__version__.py"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"