Skip to main content

Use your Hermes Agent like an AI API: one-shot exec CLI (codex-exec style) with session self-cleanup

Project description

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.

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cluxion_hermes_call_cli-0.1.1.tar.gz (20.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

cluxion_hermes_call_cli-0.1.1-py3-none-any.whl (19.4 kB view details)

Uploaded Python 3

File details

Details for the file cluxion_hermes_call_cli-0.1.1.tar.gz.

File metadata

  • Download URL: cluxion_hermes_call_cli-0.1.1.tar.gz
  • Upload date:
  • Size: 20.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for cluxion_hermes_call_cli-0.1.1.tar.gz
Algorithm Hash digest
SHA256 a7db191af6415b13fa2727c31ad5a9acc63a5cb5dde4eff4291df4d597f1b377
MD5 052661012e5e2c38f23023685d4c4cb5
BLAKE2b-256 cc7c5f831b2a259c9d9d4b6d640aed4b5804cd235e538712e7174e56b68af540

See more details on using hashes here.

Provenance

The following attestation bundles were made for cluxion_hermes_call_cli-0.1.1.tar.gz:

Publisher: publish.yml on cluxion/cluxion-Hermes-call-cli

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file cluxion_hermes_call_cli-0.1.1-py3-none-any.whl.

File metadata

File hashes

Hashes for cluxion_hermes_call_cli-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 188ddd42c1fb3448c9445c28323ed287601632581f1a0b50d1797ceb71b6c488
MD5 2c6734c4fbc6d9bc5accd9c0def1c76d
BLAKE2b-256 155e15b930e3ecc5b9110b8c01a84692e1a65fa824dd1a30e9a36ad9a11ea6f9

See more details on using hashes here.

Provenance

The following attestation bundles were made for cluxion_hermes_call_cli-0.1.1-py3-none-any.whl:

Publisher: publish.yml on cluxion/cluxion-Hermes-call-cli

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page