agentsummons

Python wrapper around agentsummons, a Go library + CLI that invokes agent harnesses (Antigravity CLI, Claude Code, Codex CLI) headlessly: it owns the per-harness flag knowledge so scripts and experiments don't have to rediscover it.

The wheel bundles the real Go binary for your platform, plus a thin Python API.

CLI

pip install agentsummons
agentsummons run --harness claude-code -p "Summarize this repo" \
  --allowed-tools Read,Grep,Glob --auto-approve

Identical to the Go CLI — see the project README for the full surface (run, build, info, doctor).

API

import agentsummons

res = agentsummons.run(
    harness="claude-code",
    prompt="Summarize this repo",
    workdir=dir,
    allowed_tools=["Read", "Grep", "Glob"],
    auto_approve=True,
    timeout=300,
)
# res is the CLI's `run --json` envelope as a dict:
# res["exit_code"], res["stdout"], res["timed_out"], res["session_id"], ...

A nonzero harness exit is data (res["exit_code"]), not an exception; a timeout returns timed_out: True with the partial output. Bad requests raise RequestError, a missing harness binary raises NotInstalledError. build(...) returns the assembled argv without executing; binary_path() exposes the bundled binary for anything else.

Set AGENTSUMMONS_BINARY to override which binary the wrapper invokes.

Project links

Data verified by PyPI on Aug 24, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for dacharyc from gravatar.com dacharyc

Credits

Author: Dachary Carey

GitHub Statistics

Data verified by PyPI on Aug 24, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT

Requires

Python >=3.9

Tags

agent harness claude-code codex antigravity headless

Report project as malware

Download files

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

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

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

agentsummons-0.3.2-py3-none-win_arm64.whl (1.2 MB view details)

Uploaded Python 3Windows ARM64

agentsummons-0.3.2-py3-none-win_amd64.whl (1.3 MB view details)

Uploaded Python 3Windows x86-64

agentsummons-0.3.2-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.musllinux_1_1_x86_64.whl (1.2 MB view details)

Uploaded Python 3manylinux: glibc 2.17+ x86-64musllinux: musl 1.1+ x86-64

agentsummons-0.3.2-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.musllinux_1_1_aarch64.whl (1.1 MB view details)

Uploaded Python 3manylinux: glibc 2.17+ ARM64musllinux: musl 1.1+ ARM64

agentsummons-0.3.2-py3-none-macosx_11_0_arm64.whl (1.2 MB view details)

Uploaded Python 3macOS 11.0+ ARM64

agentsummons-0.3.2-py3-none-macosx_10_13_x86_64.whl (1.2 MB view details)

Uploaded Python 3macOS 10.13+ x86-64

File details

Details for the file agentsummons-0.3.2-py3-none-win_arm64.whl.

File metadata

  • Download URL: agentsummons-0.3.2-py3-none-win_arm64.whl
  • Upload date:
  • Size: 1.2 MB
  • Tags: Python 3, Windows ARM64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for agentsummons-0.3.2-py3-none-win_arm64.whl
Algorithm Hash digest
SHA256 117bc3902ccc0941fd8f73339eadaf7fea3cd23994b9d6b1d83e0b3f3d5ff88e
MD5 64ad2df8fc733dd1d965448be6bedffb
BLAKE2b-256 89d70d643ba22b730b7c79934f8a54f6c6f9027d204f45509336b636b1f6b32c

See more details on using hashes here.

Provenance

The following attestation bundles were made for agentsummons-0.3.2-py3-none-win_arm64.whl:

Publisher: release.yml on agent-ecosystem/agentsummons

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

File details

Details for the file agentsummons-0.3.2-py3-none-win_amd64.whl.

File metadata

  • Download URL: agentsummons-0.3.2-py3-none-win_amd64.whl
  • Upload date:
  • Size: 1.3 MB
  • Tags: Python 3, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for agentsummons-0.3.2-py3-none-win_amd64.whl
Algorithm Hash digest
SHA256 07f0f4c362a54c49759edaf3816acc02ae8dae8747e573619dced427877068ea
MD5 ea10bb4d69aa8a9411eca63e4e3290da
BLAKE2b-256 e964508d45c154710c1b04568a0325b9e45ce75e030e1ea7689e20a9f1e8a344

See more details on using hashes here.

Provenance

The following attestation bundles were made for agentsummons-0.3.2-py3-none-win_amd64.whl:

Publisher: release.yml on agent-ecosystem/agentsummons

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

File details

Details for the file agentsummons-0.3.2-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.musllinux_1_1_x86_64.whl.

File metadata

File hashes

Hashes for agentsummons-0.3.2-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.musllinux_1_1_x86_64.whl
Algorithm Hash digest
SHA256 77b76f9864820e8b97aec582b2348372d6a391654bf0ffd4c956b92104773c8e
MD5 36922f60893d5aaf959f18fc8b5e888b
BLAKE2b-256 cd7fda154eeb8981e9efd63f8af93660aca4156dd97cce54a01234cf424f2787

See more details on using hashes here.

Provenance

The following attestation bundles were made for agentsummons-0.3.2-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.musllinux_1_1_x86_64.whl:

Publisher: release.yml on agent-ecosystem/agentsummons

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

File details

Details for the file agentsummons-0.3.2-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.musllinux_1_1_aarch64.whl.

File metadata

File hashes

Hashes for agentsummons-0.3.2-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.musllinux_1_1_aarch64.whl
Algorithm Hash digest
SHA256 af4b540d9ae60dc54f5be0209eca729332b9019169f1d36d683ffa8b158596cf
MD5 2eb96c98f66411c5a22a93d041f463ea
BLAKE2b-256 d9859eb6fb9b61e25fa1393db7c1555aa49a03b6e11aeffc0162ba7671445ad2

See more details on using hashes here.

Provenance

The following attestation bundles were made for agentsummons-0.3.2-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.musllinux_1_1_aarch64.whl:

Publisher: release.yml on agent-ecosystem/agentsummons

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

File details

Details for the file agentsummons-0.3.2-py3-none-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for agentsummons-0.3.2-py3-none-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 2514396047a12d600fd78e66c6094c2714ad2090cd2b4cb1e707dee92d5bc129
MD5 9154f08858be101b545b327ed2b31fc7
BLAKE2b-256 2566592d1916273d44360c254ba6453a0dedb30dc1008805277d4137ab176a1c

See more details on using hashes here.

Provenance

The following attestation bundles were made for agentsummons-0.3.2-py3-none-macosx_11_0_arm64.whl:

Publisher: release.yml on agent-ecosystem/agentsummons

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

File details

Details for the file agentsummons-0.3.2-py3-none-macosx_10_13_x86_64.whl.

File metadata

File hashes

Hashes for agentsummons-0.3.2-py3-none-macosx_10_13_x86_64.whl
Algorithm Hash digest
SHA256 75cbb83662ecc260d83010487e7a2b4b3336004c72d083d55b93e1b35d024849
MD5 d2da512195d51f33bad24af6924aecc3
BLAKE2b-256 7dcafb413859532decbd6dfcbf2a49506378f9f6a26a2f68e4968751dc1b2c62

See more details on using hashes here.

Provenance

The following attestation bundles were made for agentsummons-0.3.2-py3-none-macosx_10_13_x86_64.whl:

Publisher: release.yml on agent-ecosystem/agentsummons

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

Release history Release notifications | RSS feed

This release

0.3.2 This release

6 files

0.3.1

6 files

0.3.0

6 files

0.2.2

6 files

0.2.1

6 files

0.2.0

6 files

0.1.0

6 files

0.0.1

2 files

Supported by

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