Metadata-Version: 2.4
Name: cluxion-hermes-call-cli
Version: 0.1.1
Summary: Use your Hermes Agent like an AI API: one-shot exec CLI (codex-exec style) with session self-cleanup
Project-URL: Repository, https://github.com/cluxion/cluxion-Hermes-call-cli
Author: cluxion
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: agent,cli,hermes,llm,oneshot
Classifier: Development Status :: 3 - Alpha
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.11
Provides-Extra: dev
Requires-Dist: pytest>=8; extra == 'dev'
Requires-Dist: ruff>=0.8; extra == 'dev'
Description-Content-Type: text/markdown

# cluxion-Hermes-call-cli

Use your Hermes Agent like an AI API key: a one-shot exec CLI (codex-exec style) on top of
the official hermes oneshot path, with fail-closed session self-cleanup.

```bash
hermes-call "create result.json in my Downloads folder"   # agentic, tools enabled (codex exec style)
hermes-call --ask "why does this error happen?"           # answer only, tools blocked
cat task.md | hermes-call -                               # stdin delegation for codex/claude
hermes-call doctor                                       # static host Hermes compatibility checks
hermes-call doctor --live                                # includes one tiny --ask/no-tools round-trip
```

`doctor` prints readable check lines to stderr and a final JSON object to stdout:
`{"ok":true,"checks":[...]}`. Static mode checks the Hermes binary/version, `-z`/`-t`
help flags, session subcommands, current `hermes sessions list` parsing, and the
`~/.cluxion_hermes/jobs` marker round-trip. `--live` also verifies that `--ask`
returns an answer, the no-tool toolset still answers `NO_TOOLS`, and the session
created by the probe is cleaned up.

Session cleanup is fail-closed. A single new Hermes session ID is deleted. If
parallel Hermes runs create multiple new IDs, `hermes-call` exports those candidates
and deletes only the one whose exported `cwd` exactly matches this run's resolved cwd.
If the match is missing, ambiguous, or export fails, no session is deleted and JSON
results include `session_cleaned=false` with a reason. `--sandbox` gives each run a
unique cwd, so concurrent cleanup can usually be unambiguous.

Status: under active development. Install: `pip install cluxion-hermes-call-cli`
