#701 by GitHub stars

brayonpi/hexstellar

Decide, don't guess — trigger on ANY combinatorial or ground-state decision where a plausible guess is worse than silence: rosters and on-call schedules, packing and placement, RAG passage selection, frequency/register coloring, judge consensus, set cover, QUBO/Ising, spectra, integer relations. The

Codex GitHub Copilot Engineering Research

History

Review weekly changes to SKILL.md before updating. Dates mark the weeks in which we observed each version; checks apply to the recorded commits.

View weekly changes

`SKILL.md`

Week of Nov 2, 2026 · +0 / −0 lines

Before Network or broad shell → After Network or broad shell

aae0d6a670c2 → aae0d6a670c2

Diff text is unavailable under the recorded licenses. Line counts and the GitHub link remain available.

Compare on GitHub

Week of Oct 26, 2026 · Line counts unavailable

Before Not checked yet → After Network or broad shell

First observation → aae0d6a670c2

No earlier version was observed for comparison.

Compare on GitHub

View on GitHub Add to my skills

Verified commit aae0d6a670c29d999fbde23ee6e2f6228ec92d90

Version-pinned installation · Codex

git clone --filter=blob:none --no-checkout https://github.com/brayonpi/hexstellar.git .hotskills/brayonpi-hexstellar && git -C .hotskills/brayonpi-hexstellar checkout --detach aae0d6a670c29d999fbde23ee6e2f6228ec92d90
# Copy each selected skill directory from .hotskills/brayonpi-hexstellar into .agents/skills/<skill-name>/

Version-pinned installation · GitHub Copilot

git clone --filter=blob:none --no-checkout https://github.com/brayonpi/hexstellar.git .hotskills/brayonpi-hexstellar && git -C .hotskills/brayonpi-hexstellar checkout --detach aae0d6a670c29d999fbde23ee6e2f6228ec92d90
# Copy each selected skill directory from .hotskills/brayonpi-hexstellar into .github/skills/<skill-name>/

1.3kGitHub stars

-100stars in 7 days

1skill in this repository

0commits in 30 days

Heat

0.0

Star growth, last 7 daysAhead of 0% of tracked repositories
Star growth, last 24 hoursAhead of 0% of tracked repositories
Rank movement, last 7 daysAhead of 0% of tracked repositories
Commits, last 30 daysAhead of 0% of tracked repositories
Accounts asking about it through MCP, last 7 daysNot available
Hot votes this weekAhead of 0% of tracked repositories

Heat never changes the order by stars, and sponsorship never touches it. How heat works

Stars over time

Individual skills in this repository

hexstellar /

How it works

hexstellar

When your agent uses it

Decide, don't guess — trigger on ANY combinatorial or ground-state decision where a plausible guess is worse than silence: rosters and on-call schedules, packing and placement, RAG passage selection, frequency/register coloring, judge consensus, set cover, QUBO/Ising, spectra, integer relations. The HexStellar CLI takes the decision as JSON and returns a result with explicit assurance and a verifiable receipt. The live examples are encoding recipes to mutate, not the allowed problem set. Not for text generation, retrieval, or unsupported proof claims.

What it loads into context

Frontmatter

118 tokens

Always available to the agent

SKILL.md

4,304 tokens

When the skill is activated

Reference documents

56,396 tokens

Loaded on request

Token counts are estimates. Scripts run separately; they are not counted as reference context.

The playbook

One platform, two connected delivery surfaces
Examples teach the form; the schema is the language
Route by FAMILY, not by a single command
The mandatory workflow (in order — skipping steps is how agents end up reporting the demo)
Domain triggers → command → recipe
When to reach for it
Canonical workflow (each step is free until the solve)
The contract you can program against
Guard rails you should use
Edge cases that waste a first request
Bring your own agent
Deeper references (load only when needed)
Worked examples — how to fetch the live catalogue

Scripts executed separately

hexstellar/__init__.py
hexstellar/__main__.py
hexstellar/_config.py
hexstellar/_errors.py
hexstellar/_hxsb.py
hexstellar/_idempotency.py
hexstellar/_jobs.py
hexstellar/_manifest.py
hexstellar/_meta.py
hexstellar/_output.py
hexstellar/_problem.py
hexstellar/_reporting.py
hexstellar/_storage.py
hexstellar/_transport.py
hexstellar/api.py
hexstellar/cli.py
hexstellar/commands/__init__.py
hexstellar/commands/account.py
hexstellar/commands/agent.py
hexstellar/commands/completion.py
hexstellar/commands/docs.py
hexstellar/commands/enterprise.py
hexstellar/commands/info.py
hexstellar/commands/jobs.py
hexstellar/commands/mcp.py
hexstellar/commands/report.py
hexstellar/commands/solve.py
hexstellar/commands/verify.py
hexstellar/welcome.py

Files

.github/copilot-instructions.mddoc876 bytes
.github/workflows/ci.ymlasset2,627 bytes
.github/workflows/publish.ymlasset4,076 bytes
.gitignoreasset192 bytes
AGENTS-DOMAIN.mddoc12,065 bytes
AGENTS.mddoc21,108 bytes
AGENT_SPEC.mddoc97,890 bytes
AGENT_SYSTEM_PROMPT.mddoc12,274 bytes
AI_MANIFEST.jsonasset126,095 bytes
AI_PROMPT_TEMPLATE.mddoc29,311 bytes
CHANGELOG.mddoc7,337 bytes
CITATION.cffasset994 bytes
CONTRIBUTING.mddoc1,254 bytes
HXSB_FORMAT.mddoc6,597 bytes
LICENSEasset4,010 bytes
MANIFEST.inasset569 bytes
PARAMETERS.mddoc2,207 bytes
README.mddoc48,894 bytes
SECURITY.mddoc1,960 bytes
SKILL.mdcore20,096 bytes
SKILL.mdcore20,096 bytes
SKILL.mdcore20,096 bytes
SUPPORT.mddoc2,015 bytes
enterprise-runtime.jsonasset9,672 bytes
examples/agent_action_arbiter.jsonasset13,658 bytes
examples/agtech_crop_rotation.jsonasset16,909 bytes
examples/ai_judge_consensus.jsonasset14,342 bytes
examples/ai_tensor_placement.jsonasset20,859 bytes
examples/assembly_kit_partition.jsonasset14,531 bytes
examples/bio_biomarker_panel.jsonasset14,101 bytes
examples/bio_epistasis_triple.jsonasset14,528 bytes
examples/bio_therapy_coverage.jsonasset13,878 bytes
examples/calibration_polarity_audit.jsonasset17,411 bytes
examples/cat_item_selection.jsonasset13,065 bytes
examples/cloud_gpu_scheduler.jsonasset13,209 bytes
examples/cloud_microservice_latency.jsonasset16,590 bytes
examples/compiler_register_allocation.jsonasset14,658 bytes
examples/conservation_reserve.jsonasset12,945 bytes
examples/cyber_zero_trust.jsonasset15,337 bytes
examples/design_pinned_completion.jsonasset5,293 bytes
examples/devops_dependency_resolver.jsonasset13,400 bytes
examples/devops_test_selection.jsonasset12,734 bytes
examples/edtech_curriculum_path.jsonasset13,069 bytes
examples/energy_known_ground_state.jsonasset5,204 bytes
examples/energy_microgrid_islanding.jsonasset15,681 bytes
examples/facility_session_scheduling.jsonasset14,072 bytes
examples/finance_portfolio.jsonasset12,420 bytes
examples/finance_settlement_netting.jsonasset12,340 bytes
examples/game_procedural_map.jsonasset16,550 bytes
examples/ha_failover_sync.jsonasset14,008 bytes
examples/health_icu_roster.jsonasset13,050 bytes
examples/health_shift_coverage.jsonasset14,507 bytes
examples/hpc_solver_ensemble.jsonasset14,782 bytes
examples/hub_corridor_coverage.jsonasset14,970 bytes
examples/index.jsonasset192,620 bytes
examples/infra_fault_domain_split.jsonasset13,915 bytes
examples/infra_probe_placement.jsonasset14,192 bytes
examples/infra_workload_placement.jsonasset13,348 bytes
examples/integrity_protect_payload.jsonasset4,870 bytes
examples/integrity_recover_payload.jsonasset5,018 bytes
examples/legal_contract_consistency.jsonasset15,978 bytes
examples/logistics_container_incompat.jsonasset13,032 bytes
examples/logistics_crossdock_hub.jsonasset18,776 bytes
examples/logistics_last_mile.jsonasset12,473 bytes
examples/math_golden_ratio_relation.jsonasset5,118 bytes
examples/math_sqrt2_precision.jsonasset4,846 bytes
examples/math_unimodular_reduction.jsonasset5,090 bytes
examples/museum_exhibit_selection.jsonasset13,951 bytes
examples/music_key_modulation.jsonasset17,291 bytes
examples/ops_task_pipeline.jsonasset12,733 bytes
examples/paint_shop_sequencing.jsonasset13,236 bytes
examples/physics_controlled_phase.jsonasset5,091 bytes
examples/quantum_error_decoder.jsonasset14,700 bytes
examples/quantum_spin_spectrum.jsonasset14,353 bytes
examples/rag_context_packing.jsonasset13,240 bytes
examples/recycling_line_dispatch.jsonasset16,823 bytes
examples/robotics_balance_jettison.jsonasset15,629 bytes
examples/robotics_cell_layout.jsonasset15,464 bytes
examples/robotics_fleet_pathing.jsonasset21,792 bytes
examples/scale_planted_65536.jsonasset5,012 bytes
examples/science_enumerable_sampling.jsonasset5,345 bytes
examples/science_known_entropy.jsonasset5,057 bytes
examples/science_planted_frequency.jsonasset4,870 bytes
examples/security_dual_watch.jsonasset13,929 bytes
examples/security_gf2_consistency.jsonasset5,053 bytes
examples/simulator_fault_isolation.jsonasset8,407 bytes
examples/space_maneuver_deconfliction.jsonasset15,175 bytes
examples/supply_bom_sourcing.jsonasset13,050 bytes
examples/telecom_band_assignment.jsonasset12,597 bytes
examples/world_terrain_oracle.jsonasset4,775 bytes
hexstellar/__init__.pyruns12,085 bytes
hexstellar/__main__.pyruns938 bytes
hexstellar/_config.pyruns15,288 bytes
hexstellar/_errors.pyruns16,147 bytes
hexstellar/_hxsb.pyruns5,313 bytes
hexstellar/_idempotency.pyruns1,277 bytes
hexstellar/_jobs.pyruns9,965 bytes
hexstellar/_manifest.pyruns9,393 bytes
hexstellar/_meta.pyruns5,512 bytes
hexstellar/_output.pyruns9,642 bytes
hexstellar/_problem.pyruns13,008 bytes
hexstellar/_reporting.pyruns3,886 bytes
hexstellar/_storage.pyruns6,693 bytes
hexstellar/_transport.pyruns23,690 bytes
hexstellar/api.pyruns32,049 bytes
hexstellar/cli.pyruns45,963 bytes
hexstellar/commands/__init__.pyruns1,161 bytes
hexstellar/commands/account.pyruns19,240 bytes
hexstellar/commands/agent.pyruns13,662 bytes
hexstellar/commands/completion.pyruns6,359 bytes
hexstellar/commands/docs.pyruns14,483 bytes
hexstellar/commands/enterprise.pyruns26,148 bytes
hexstellar/commands/info.pyruns23,136 bytes
hexstellar/commands/jobs.pyruns2,335 bytes
hexstellar/commands/mcp.pyruns8,152 bytes
hexstellar/commands/report.pyruns3,233 bytes
hexstellar/commands/solve.pyruns30,089 bytes
hexstellar/commands/verify.pyruns9,273 bytes
hexstellar/welcome.pyruns5,764 bytes
llms.txtdoc21,610 bytes
pyproject.tomlasset7,911 bytes

No excerpt is shown for this license. Read the source on GitHub.

View the complete source on GitHub

Skills included

hexstellar

Repository facts

License: No license detected
Created: Aug 27, 2026
Last pushed: Aug 27, 2026
Forks: 68
Open issues: 0
Project activity: Slowing

Rank over the last 12 weeks

Now #701 · best #548 · down 131 in 30 days

#651 on Nov 1
#650 on Nov 2
#651 on Nov 3
#652 on Nov 4
#689 on Nov 5
#701 since Nov 6

62 earlier periods

#922 on Aug 23
#927 on Aug 27
#879 on Aug 30
#912 on Sep 1
#837 on Sep 2
#788 on Sep 3
#716 on Sep 4
#685 on Sep 5
#705 on Sep 6
#714 on Sep 7
#715 on Sep 8
#661 on Sep 9
#645 on Sep 10
#615 on Sep 11
#608 on Sep 12
#597 on Sep 13
#610 on Sep 14
#600 on Sep 15
#605 on Sep 16
#603 on Sep 17
#599 on Sep 18
#577 on Sep 19
#579 on Sep 20
#583 on Sep 21
#589 on Sep 22
#585 on Sep 23
#563 on Sep 24
#556 on Sep 25
#555 on Sep 26
#576 on Sep 27
#575 on Sep 28
#595 on Sep 29
#581 on Sep 30
#562 on Oct 1
#567 on Oct 2
#548 on Oct 3
#552 on Oct 4
#561 on Oct 5
#567 on Oct 6
#570 on Oct 7
#594 on Oct 8
#581 on Oct 9
#564 on Oct 10
#566 on Oct 11
#575 on Oct 12
#576 on Oct 13
#585 on Oct 14
#580 on Oct 15
#584 on Oct 16
#575 on Oct 17
#570 on Oct 18
#587 on Oct 19
#594 on Oct 20
#599 on Oct 21
#585 on Oct 22
#578 on Oct 23
#567 on Oct 24
#631 on Oct 25
#637 on Oct 28
#641 on Oct 29
#648 on Oct 30
#649 on Oct 31

Before you install

Network or broad shell

Automated signals, not a guarantee

Checked Nov 3, 2026

Not fully analyzed: some files were too long, unreadable or missing. This never lowers the level.

Show 2 notes

SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed

No broad tool permissions
2 dangerous shell commandsin 2 files: AGENT_SPEC.md:242 HXSB_FORMAT.md:138
242 network referencesin 31 files: README.md:1 enterprise-runtime.json:45 hexstellar/_errors.py:22 and 28 more
No hidden or obfuscated text
No instruction overrides
29 executable scriptsin 29 files: hexstellar/__init__.py:1 hexstellar/__main__.py:1 hexstellar/_config.py:1 and 26 more
53 references to secretsin 23 files: hexstellar/commands/account.py:30 hexstellar/_config.py:24 hexstellar/cli.py:97 and 20 more
No requests to vote in Hot

Show all 326 signals by file

`.github/workflows/ci.yml`

Network accessline 47

# NO LOCAL SOLVING: an offline solve must ERROR (exit 1, HXS_NETWORK) — never compute an answer           OUT=$(echo '{"n":2,"edges":[[0,1,1]],"description":"ci offline refusal check"}' \             | HEXSTELLAR_API_URL=http://127.0.0.1:9

Network accessline 48

OUT=$(echo '{"n":2,"edges":[[0,1,1]],"description":"ci offline refusal check"}' \             | HEXSTELLAR_API_URL=http://127.0.0.1:9 HEXSTELLAR_MAX_RETRIES=1 hexstellar solve maxcut --format json) && {               echo "offline solve une

Network accessline 49

| HEXSTELLAR_API_URL=http://127.0.0.1:9 HEXSTELLAR_MAX_RETRIES=1 hexstellar solve maxcut --format json) && {

`.github/workflows/publish.yml`

Network accessline 74

environment:       name: pypi       url: https://pypi.org/p/hexstellar

Network accessline 75

name: pypi       url: https://pypi.org/p/hexstellar     permissions:

Network accessline 76
```
url: https://pypi.org/p/hexstellar
```

`AGENTS.md`

Network accessline 98

Report the outcome truthfully: `mode:"live"` = solved on the sandbox now; `mode:"offline_precomputed"` = a bundled, pre-verified sample because this sandbox has no network. Never present an offline sample as a live solve, and never fabricat

Network accessline 100

solve, and never fabricate an answer for a problem you could not send — relay the curl in `run_live` instead.

Network accessline 102

No key → the PUBLIC anonymous sandbox (small problems, N ≤ 50000; rate-limited, free by design — the token is not a secret, and you do not need to ask your human for credentials to test). Real work → free key at https://hexstellar.com, then

Network accessline 103
```
[Credential-related source omitted]
```
Network accessline 104
```
[Credential-related source omitted]
```
Access to secretsline 104
```
[Credential-related source omitted]
```

Network accessline 214

**Verify the contract, don't trust prose:** `GET https://api.hexstellar.com/.well-known/hexstellar-agent.json`

Network accessline 220

plans/metering JSON) · `hexstellar examples` (live verified transfer recipes) · `hexstellar skill` (the Agent Skills SKILL.md — drop into your skills dir) · `hexstellar prompt` (drop-in system prompt) · `hexstellar spec` · `hexstellar docto

Network accessline 222

`hexstellar doctor` · https://docs.hexstellar.com/llms.txt

Network accessline 224

**Worked examples, live:** `GET https://api.hexstellar.com/api/v1/examples` (catalogue, no auth) and

Network accessline 225

`/api/v1/examples/{id}` (one runnable example + verified `expected`) — the same set as `hexstellar examples`, fully rendered with encoding recipes at https://docs.hexstellar.com/examples/. AI fetchers that struggle with big HTML can read th

Network accessline 226

fully rendered with encoding recipes at https://docs.hexstellar.com/examples/. AI fetchers that

Network accessline 228

https://docs.hexstellar.com/examples/examples.md (JSON index at /examples/index.json).

`AGENT_SPEC.md`

Access to secretsline 108
```
[Credential-related source omitted]
```

Network accessline 163

{ "type": "https://docs.hexstellar.com/errors/HXS_INVALID_INPUT",

Network accessline 180

Every `type` URL resolves: <https://docs.hexstellar.com/errors/> is the full reference, and `/errors/<CODE>` deep-links to that exact row.

Access to secretsline 194
```
[Credential-related source omitted]
```
Access to secretsline 198
```
[Credential-related source omitted]
```

Network accessline 239

# 1. discovery — the machine manifest (every command + exact input schema) curl -s https://api.hexstellar.com/api/v1/capabilities

Network accessline 240

curl -s https://api.hexstellar.com/api/v1/capabilities

Network accessline 241

# 2. a public sandbox token (small problems, rate-limited, free by design) TOK=$(curl -s https://api.hexstellar.com/api/v1/sandbox | python3 -c 'import json,sys; print(json.load(sys.stdin)["token"])') # 3. FREE preflight (nothing charged):

Dangerous shell operationline 242

TOK=$(curl -s https://api.hexstellar.com/api/v1/sandbox | python3 -c 'import json,sys; print(json.load(sys.stdin)["token"])')

Network accessline 242

TOK=$(curl -s https://api.hexstellar.com/api/v1/sandbox | python3 -c 'import json,sys; print(json.load(sys.stdin)["token"])')

Network accessline 243
```
[Credential-related source omitted]
```
Network accessline 244
```
[Credential-related source omitted]
```
Network accessline 245
```
[Credential-related source omitted]
```
Network accessline 246
```
[Credential-related source omitted]
```
Network accessline 247
```
[Credential-related source omitted]
```

Network accessline 260

**B. `HXS_MISSING_TAG` on your first curl.** Raw HTTP must carry `"tag": "hexstellar-cortex-v1"` at the top level. It is a fixed constant, not information. The CLI and the Python client fill it for you — curl has no client to do it, which i

`AI_MANIFEST.json`

Access to secretsline 196
```
[Credential-related source omitted]
```

`AI_PROMPT_TEMPLATE.md`

Network accessline 97

contract. The sandbox token is public by design, not a secret, and you do not need to ask your human for credentials to test. When a request exceeds a cap, the service names the measured dimensions and current limits. **Getting a key is fre

Network accessline 98

to test. When a request exceeds a cap, the service names the measured dimensions and current limits. **Getting a key is free: register at https://hexstellar.com, confirm your email, and you get your own key** with much higher limits. Then `

Network accessline 99

is free: register at https://hexstellar.com,

Access to secretsline 101
```
[Credential-related source omitted]
```

Network accessline 103

**Running inside a chat-interface Python sandbox?** `import hexstellar` and use the Python API directly: `hexstellar.demo()` (adaptive: live sandbox solve, or a bundled engine-verified result when your sandbox has no network — honestly labe

Network accessline 104

`hexstellar.demo()` (adaptive: live sandbox solve, or a bundled engine-verified result when your sandbox has no network — honestly labeled, plus a ready curl for the human), `hexstellar.solve(cmd, problem, description=…)`, `hexstellar.verif

Network accessline 105

network — honestly labeled, plus a ready curl for the human), `hexstellar.solve(cmd, problem, description=…)`,

Network accessline 106

`hexstellar.verify(...)`, `hexstellar.estimate(...)` — every function returns a dict, never raises remotely. **Report the result honestly:** read `demo()`'s `mode` and tell the user what actually happened — a live sandbox solve, or a bundle

Network accessline 107

**Report the result honestly:** read `demo()`'s `mode` and tell the user what actually happened — a live sandbox solve, or a bundled offline sample with the curl to run it live. Never dress an offline sample as a live solve, and never inven

Network accessline 108

solve, or a bundled offline sample with the curl to run it live. Never dress an offline sample as a live solve,

Network accessline 109

and never invent an answer for a problem the sandbox blocked — an honest "computed offline / run this curl live"

Network accessline 288

- **Live catalogue (no auth):** `GET https://api.hexstellar.com/api/v1/examples` · one: `GET https://api.hexstellar.com/api/v1/examples/{id}`

Network accessline 290

- **CLI:** `hexstellar examples` · `hexstellar example <id>` (pipe it: `--format json | hexstellar solve <cmd>`) - **Python:** `hexstellar.examples()` / `hexstellar.example("<id>")` — both return dicts - **For AI fetchers:** the whole catal

Network accessline 291

- **Python:** `hexstellar.examples()` / `hexstellar.example("<id>")` — both return dicts - **For AI fetchers:** the whole catalogue as one markdown file: https://docs.hexstellar.com/examples/examples.md   (index as JSON: https://docs.hexste

Network accessline 292

- **For AI fetchers:** the whole catalogue as one markdown file: https://docs.hexstellar.com/examples/examples.md

Network accessline 293

(index as JSON: https://docs.hexstellar.com/examples/index.json · browser page: https://docs.hexstellar.com/examples/)

`CHANGELOG.md`

Network accessline 6

The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/); versions follow

Network accessline 7

[Semantic Versioning](https://semver.org/spec/v2.0.0.html).

Access to secretsline 52
```
[Credential-related source omitted]
```

`CITATION.cff`

Network accessline 10

version: "1.0.0" date-released: "2026-08-27" url: "https://hexstellar.com"

Network accessline 11

date-released: "2026-08-27" url: "https://hexstellar.com" repository-code: "https://github.com/brayonpi/hexstellar"

Network accessline 12
```
url: "https://hexstellar.com"
```

Network accessline 13

repository-code: "https://github.com/brayonpi/hexstellar"

Network accessline 24

- ai-agents   - cli license-url: "https://docs.hexstellar.com/"

Network accessline 26

license-url: "https://docs.hexstellar.com/"

`HXSB_FORMAT.md`

Access to secretsline 15
```
[Credential-related source omitted]
```
Network accessline 95
```
[Credential-related source omitted]
```
Access to secretsline 95
```
[Credential-related source omitted]
```
Access to secretsline 96
```
[Credential-related source omitted]
```

Network accessline 120

The layout above is the whole contract. This encoder produces a valid HXSB body for `optimize` (command byte 1; use 2 for `maxcut` with edges in the quadratic block), gzip-compresses it, and the curl line ships it — nothing beyond Python's

Network accessline 122

curl line ships it — nothing beyond Python's standard library:

Dangerous shell operationline 138

TOK=$(curl -s https://api.hexstellar.com/api/v1/sandbox | python3 -c 'import json,sys; print(json.load(sys.stdin)["token"])')

Network accessline 138

TOK=$(curl -s https://api.hexstellar.com/api/v1/sandbox | python3 -c 'import json,sys; print(json.load(sys.stdin)["token"])')

Network accessline 139

curl -s -X POST 'https://api.hexstellar.com/api/v1/compute/binary?effort=medium' \

`LICENSE`

Network accessline 55

7. SERVICE TERMS AND ENTERPRISE. Use of the public sandbox, free tier, hosted    Cortex service, and any automated agent integration is also governed by the    then-current Terms at https://hexstellar.com/legal. Enterprise Low-Energy

Network accessline 56

Cortex service, and any automated agent integration is also governed by the    then-current Terms at https://hexstellar.com/legal. Enterprise Low-Energy    Runtime & Acceleration is not licensed by this Client license; customer

Network accessline 57

then-current Terms at https://hexstellar.com/legal. Enterprise Low-Energy

`README.md`

Network accessline 1

<p align="center">   <img src="https://docs.hexstellar.com/assets/banner.png" alt="HexStellar — verified computation for hard optimization and decision problems" width="100%">

Network accessline 2

<img src="https://docs.hexstellar.com/assets/banner.png" alt="HexStellar — verified computation for hard optimization and decision problems" width="100%">

Network accessline 7

> **Distribution status:** this repository is the public HexStellar CLI 1.0 source. The PyPI 1.x > distribution is activated in a separate, audited release step. Until > [`pypi.org/project/hexstellar`](https://pypi.org/project/hexstellar/)

Network accessline 8

> distribution is activated in a separate, audited release step. Until > [`pypi.org/project/hexstellar`](https://pypi.org/project/hexstellar/) reports a `1.x` release, install > this source with `python -m pip install "git+https://github.co

Network accessline 9

> [`pypi.org/project/hexstellar`](https://pypi.org/project/hexstellar/) reports a `1.x` release, install

Network accessline 10

> this source with `python -m pip install "git+https://github.com/brayonpi/hexstellar.git"` or use the

Network accessline 148

<p align="center">   <a href="https://pypi.org/project/hexstellar/"><img src="https://docs.hexstellar.com/assets/banner-install-dark.png" alt="pip install hexstellar — HexStellar" width="360"></a>

Network accessline 149

<a href="https://pypi.org/project/hexstellar/"><img src="https://docs.hexstellar.com/assets/banner-install-dark.png" alt="pip install hexstellar — HexStellar" width="360"></a>

Network accessline 171

That is a full small run: solve, then a free service re-check of supported properties. **Zero dependencies** (Python standard library only), Python 3.8–3.14. With no key you are on the **public anonymous sandbox** (small problems, rate-limi

Network accessline 185

| Any framework | `hexstellar tools --target openai\|anthropic\|json-schema\|mcp` — typed tool specs, no MCP host required | | IDE wiring | `hexstellar init-agent` writes the agent prompt into `.cursorrules` / `AGENTS.md` | | Working templa

Network accessline 186

| IDE wiring | `hexstellar init-agent` writes the agent prompt into `.cursorrules` / `AGENTS.md` | | Working templates | `hexstellar examples` — the **live catalogue of runnable transfer recipes**, updated without reinstalling, at https://d

Network accessline 187

| Working templates | `hexstellar examples` — the **live catalogue of runnable transfer recipes**, updated without reinstalling, at https://docs.hexstellar.com/examples/ |

Network accessline 188

| Machine docs | `llms.txt`, `AGENT_SPEC.md`, `AI_PROMPT_TEMPLATE.md` ship in the wheel and live at https://docs.hexstellar.com |

Network accessline 259

Register a free key at **https://hexstellar.com**, then:

Access to secretsline 262
```
[Credential-related source omitted]
```

Network accessline 267

Point the client at the default API or at a specific approved HexStellar endpoint with `HEXSTELLAR_API_URL` or `hexstellar login --url …` (default `https://api.hexstellar.com`). This configuration option is not a claim that public self-host

Network accessline 361

{ "type": "https://docs.hexstellar.com/errors/HXS_RATE_LIMITED", "title": "Rate limited",

Network accessline 367

Every `type` resolves to the [error reference](https://docs.hexstellar.com/errors/). Branch on `code` and `retryable`; honor `retry_after`; follow `agent_fix_prompt` — the remedy written as a direct instruction (retry / repair / pause and a

Network accessline 400

- `hexstellar spec` — the exhaustive agent specification (fetches the **latest** live; `--offline` for bundled). Also ships as `AGENT_SPEC.md`. - `hexstellar prompt` — a drop-in system prompt for your agent (`AI_PROMPT_TEMPLATE.md` in the w

Network accessline 401

- `hexstellar prompt` — a drop-in system prompt for your agent (`AI_PROMPT_TEMPLATE.md` in the wheel). - `hexstellar skill` — the [Agent Skills](https://agentskills.io) `SKILL.md` (ships in the wheel): drop it into your agent's skills direc

Network accessline 402

- `hexstellar skill` — the [Agent Skills](https://agentskills.io) `SKILL.md` (ships in the wheel): drop it into your agent's skills directory and it knows HexStellar.

Network accessline 403

- `hexstellar pricing` — plans + metering as public JSON (no auth); answers past 50% of the daily quota carry a `usage_alert` ladder (50/80/95%). - `hexstellar examples` / `hexstellar example <id>` — the **live** catalogue of verified trans

Network accessline 404

- `hexstellar examples` / `hexstellar example <id>` — the **live** catalogue of verified transfer recipes, updated server-side without a reinstall; rendered at https://docs.hexstellar.com/examples/.

Network accessline 406

- `https://docs.hexstellar.com/llms.txt` — the machine-readable front page for AI fetchers.

Network accessline 422

For licensed evaluation, research collaboration or deployment discussion, visit **https://hexstellar.com/#contact**.

Network accessline 426

This package is a **thin client**: it contains no solver. It packages your request, sends it over HTTPS with your key, and prints the reply. **Zero dependencies** (standard library only), standard TLS, and it warns before ever sending a bea

Network accessline 471

default; inspect with `report status`, preview with `--dry-run`, or opt out with `report off`) or write to   **support@hexstellar.com**. Reports carrying the RFC 9457 `code` are especially useful. - **Want to go past sandbox scale?** [Regis

Network accessline 472

**support@hexstellar.com**. Reports carrying the RFC 9457 `code` are especially useful. - **Want to go past sandbox scale?** [Register a free key](https://hexstellar.com) and re-run at full size. - **Browse the live transfer recipes** at [d

Network accessline 473

- **Want to go past sandbox scale?** [Register a free key](https://hexstellar.com) and re-run at full size.

Network accessline 474

- **Browse the live transfer recipes** at [docs.hexstellar.com/examples](https://docs.hexstellar.com/examples/) — copy one, adapt the formulation to your data, and run it.

Network accessline 478

1. **Run the quickstart above** — no signup, no key, sandbox-sized, runs verbatim. 2. **Browse the live worked recipes** at https://docs.hexstellar.com/examples/ — copy one, adapt it to your data, and run.

Network accessline 479

2. **Browse the live worked recipes** at https://docs.hexstellar.com/examples/ — copy one, adapt it to your data, and run.

Network accessline 480

3. **Register free** at https://hexstellar.com for full scale, then `hexstellar login`.

Network accessline 482

5. **Watch the service live** at https://status.hexstellar.com · health probe: https://api.hexstellar.com/api/v1/health · package: https://pypi.org/project/hexstellar/.

Network accessline 496

Yes. With no key configured, every call uses the public anonymous sandbox — small problems, rate-limited, free by design, and the sandbox token is not a secret. `pip install hexstellar && hexstellar demo` works with zero signup, zero config

Network accessline 512

Testing is free: the anonymous sandbox needs no account, and registering at https://hexstellar.com issues a free key for real work. Live plans and metering are public JSON — `hexstellar pricing` or `GET /api/v1/pricing`, no auth required. V

`SECURITY.md`

Network accessline 25

- **Keys never travel in cleartext.** The client REFUSES to send a bearer key over plain `http://` to a

`SKILL.md`

Network accessline 147

No API key → the PUBLIC anonymous sandbox (N ≤ 50000; free by design — the token is not a secret; no need to ask your human for credentials to test). Real work: free key at https://hexstellar.com, then

Network accessline 148

your human for credentials to test). Real work: free key at https://hexstellar.com, then `hexstellar login --key <KEY>` or `HEXSTELLAR_API_KEY`. Air-gapped sandbox? `demo` still succeeds (bundled, engine-verified result, honestly labeled) a

Access to secretsline 149
```
[Credential-related source omitted]
```

Network accessline 150

engine-verified result, honestly labeled) and hands back the curl for a live run.

Network accessline 191

`hexstellar agent-info` (the CLI's own contract: exit codes, env vars, per-command risk facts) · `hexstellar capabilities` · `hexstellar pricing` · `hexstellar examples` (live transfer recipes) · `hexstellar spec` (the exhaustive per-comman

Network accessline 193

`hexstellar spec` (the exhaustive per-command spec) · https://docs.hexstellar.com/llms.txt

Network accessline 197

- **Live catalogue (no auth):** `GET https://api.hexstellar.com/api/v1/examples` · one: `GET https://api.hexstellar.com/api/v1/examples/{id}`

Network accessline 199

- **CLI:** `hexstellar examples` · `hexstellar example <id>` (pipe it: `--format json | hexstellar solve <cmd>`) - **Python:** `hexstellar.examples()` / `hexstellar.example("<id>")` — both return dicts - **For AI fetchers:** the whole catal

Network accessline 200

- **Python:** `hexstellar.examples()` / `hexstellar.example("<id>")` — both return dicts - **For AI fetchers:** the whole catalogue as one markdown file: https://docs.hexstellar.com/examples/examples.md   (index as JSON: https://docs.hexste

Network accessline 201

- **For AI fetchers:** the whole catalogue as one markdown file: https://docs.hexstellar.com/examples/examples.md

Network accessline 202

(index as JSON: https://docs.hexstellar.com/examples/index.json · browser page: https://docs.hexstellar.com/examples/)

`SUPPORT.md`

Network accessline 6

- **Documentation:** https://docs.hexstellar.com — quickstart, CLI reference, and the live catalogue of runnable recipes.

Network accessline 7

- **Service status:** https://status.hexstellar.com — live component checks.

Network accessline 8

- **Errors:** every failure carries an RFC 9457 `code`; the reference for each lives at   https://docs.hexstellar.com/errors/. Include the `code` (and `X-Request-Id` if present) when reporting. - **Email:** support@hexstellar.com — reports

Network accessline 9

https://docs.hexstellar.com/errors/. Include the `code` (and `X-Request-Id` if present) when reporting.

Network accessline 10

- **Email:** support@hexstellar.com — reports that include the error `code` and `hexstellar doctor`   output get the fastest answers. - **Account & keys:** https://hexstellar.com — register, manage keys, and see plan limits.

Network accessline 12

- **Account & keys:** https://hexstellar.com — register, manage keys, and see plan limits.

`enterprise-runtime.json`

Network accessline 45

"automatic_approval": false,     "activation": "unavailable",     "access_url": "https://hexstellar.com/#contact",

Network accessline 46

"activation": "unavailable",     "access_url": "https://hexstellar.com/#contact",     "contact": "brayon@hexstellar.com"

Network accessline 47

"access_url": "https://hexstellar.com/#contact",

Network accessline 87

"The campaign does not establish results for other accelerators, models, serving stacks, or workloads."       ],       "evidence_url": "https://hexstellar.com/#results"

Network accessline 88

],       "evidence_url": "https://hexstellar.com/#results"     },

Network accessline 89

"evidence_url": "https://hexstellar.com/#results"

Network accessline 109

"Its results must not be generalized to other models or workloads."       ],       "evidence_url": "https://hexstellar.com/#results"

Network accessline 110

],       "evidence_url": "https://hexstellar.com/#results"     },

Network accessline 111

"evidence_url": "https://hexstellar.com/#results"

Network accessline 132

"Per-model request-level measurements are available only through the evaluation process under NDA."       ],       "evidence_url": "https://hexstellar.com/#results"

Network accessline 133

],       "evidence_url": "https://hexstellar.com/#results"     }

Network accessline 134

"evidence_url": "https://hexstellar.com/#results"

Network accessline 140

"access": "shared directly with licensed evaluating companies under NDA",     "integrity": ["RFC 3161 timestamping", "Ed25519 aggregate records where reported"],     "request_url": "https://hexstellar.com/#contact"

Network accessline 141

"integrity": ["RFC 3161 timestamping", "Ed25519 aggregate records where reported"],     "request_url": "https://hexstellar.com/#contact"   },

Network accessline 142

"request_url": "https://hexstellar.com/#contact"

Network accessline 148

"The licensed runtime is designed for compatible compute integration, but published performance and energy measurements cover only their named campaigns."   ],   "contact": {"email": "brayon@hexstellar.com", "url": "https://hexstellar.com/#

Network accessline 149

],   "contact": {"email": "brayon@hexstellar.com", "url": "https://hexstellar.com/#contact"},   "next_actions": [

Network accessline 150

"contact": {"email": "brayon@hexstellar.com", "url": "https://hexstellar.com/#contact"},

Network accessline 151

"next_actions": [     {"action": "request_access", "command": ["hexstellar", "enterprise", "request", "--help"]},     {"action": "contact_enterprise_support", "url": "https://hexstellar.com/#contact", "human_approval_required": true}

Network accessline 152

{"action": "request_access", "command": ["hexstellar", "enterprise", "request", "--help"]},     {"action": "contact_enterprise_support", "url": "https://hexstellar.com/#contact", "human_approval_required": true}   ],

Network accessline 153

{"action": "contact_enterprise_support", "url": "https://hexstellar.com/#contact", "human_approval_required": true}

`examples/infra_fault_domain_split.json`

Network accessline 44

"suite": "G-Set",     "artifact_id": "G48",     "source_url": "https://web.stanford.edu/~yyye/yyye/Gset/",

Network accessline 45

"artifact_id": "G48",     "source_url": "https://web.stanford.edu/~yyye/yyye/Gset/",     "artifact_sha256": "2c2daba39d1f1ff1657e015f58b1a8c1cbef198fa25175c182c50eae40269b6d",

Network accessline 46

"source_url": "https://web.stanford.edu/~yyye/yyye/Gset/",

`examples/robotics_cell_layout.json`

Network accessline 45

"problem": "Tool-magazine pocket assignment on a CNC machining center",       "domain": "Machining",       "mapping": "flow -> how often tool i and tool j are called consecutively in the NC program, dist -> index cost of rotating between po

Network accessline 46

"domain": "Machining",       "mapping": "flow -> how often tool i and tool j are called consecutively in the NC program, dist -> index cost of rotating between pockets a and b, answer[i] -> the pocket for tool i, cost -> total magazine move

Network accessline 47

"mapping": "flow -> how often tool i and tool j are called consecutively in the NC program, dist -> index cost of rotating between pockets a and b, answer[i] -> the pocket for tool i, cost -> total magazine movement over the program"

`hexstellar/init.py`

Executable scriptline 1
```
Executable file
```

Network accessline 50

# Configuration (env overrides the config file): #   HEXSTELLAR_API_KEY   your API key            (or run `hexstellar login --key ...`) #   HEXSTELLAR_API_URL   service base URL        (default https://api.hexstellar.com)

Network accessline 51
```
[Credential-related source omitted]
```
Access to secretsline 51
```
[Credential-related source omitted]
```

Network accessline 52

#   HEXSTELLAR_API_URL   service base URL        (default https://api.hexstellar.com)

Access to secretsline 53
```
[Credential-related source omitted]
```

`hexstellar/main.py`

Executable scriptline 1
```
Executable file
```

`hexstellar/_config.py`

Executable scriptline 1
```
Executable file
```
Access to secretsline 24
```
[Credential-related source omitted]
```
Access to secretsline 51
```
[Credential-related source omitted]
```

Network accessline 174

"User-Agent": "hexstellar-cli/" + VERSION}         headers.update(_agent_headers())         req = urllib.request.Request(_api_url() + "/api/v1/usage", headers=headers)

Network accessline 175

headers.update(_agent_headers())         req = urllib.request.Request(_api_url() + "/api/v1/usage", headers=headers)         from ._transport import _open_url

Network accessline 176

req = urllib.request.Request(_api_url() + "/api/v1/usage", headers=headers)

Network accessline 217

headers = {"Accept": "application/json", "User-Agent": "hexstellar-cli/" + VERSION}         headers.update(_agent_headers())         req = urllib.request.Request(_api_url() + "/api/v1/sandbox", headers=headers)

Network accessline 218

headers.update(_agent_headers())         req = urllib.request.Request(_api_url() + "/api/v1/sandbox", headers=headers)         from ._transport import _open_url

Network accessline 219

req = urllib.request.Request(_api_url() + "/api/v1/sandbox", headers=headers)

Access to secretsline 238
```
[Credential-related source omitted]
```
Access to secretsline 243
```
[Credential-related source omitted]
```

Network accessline 264

"[SANDBOX MODE] No API key found — using the PUBLIC anonymous sandbox (small test problems, "                   "rate-limited, free BY DESIGN; this token is not a secret and needs no signup — safe for "                   "autonomous use). R

Network accessline 265

"rate-limited, free BY DESIGN; this token is not a secret and needs no signup — safe for "                   "autonomous use). Register a free key at https://hexstellar.com for full-scale work.\n")             _SANDBOX_NOTICE_SHOWN = True

Network accessline 266

"autonomous use). Register a free key at https://hexstellar.com for full-scale work.\n")

Access to secretsline 296
```
[Credential-related source omitted]
```

`hexstellar/_errors.py`

Executable scriptline 1
```
Executable file
```

Network accessline 22

_ERR_TYPE_BASE = "https://docs.hexstellar.com/errors/"

Network accessline 27

"status": 401, "title": "Authentication required",         "fix": "Set HEXSTELLAR_API_KEY or run `hexstellar login --key <KEY>`, then resubmit.",         "agent_fix": "Ask your human operator for a HexStellar API key (free at https://hexste

Network accessline 28
```
[Credential-related source omitted]
```
Access to secretsline 28
```
[Credential-related source omitted]
```

Network accessline 29

"agent_fix": "Ask your human operator for a HexStellar API key (free at https://hexstellar.com), then run "

Access to secretsline 30
```
[Credential-related source omitted]
```

Network accessline 68

"next_actions": [             {"action": "narrow_result", "note": "request fewer fields or a smaller result"},             {"action": "contact_support", "url": "https://hexstellar.com"},

Network accessline 69

{"action": "narrow_result", "note": "request fewer fields or a smaller result"},             {"action": "contact_support", "url": "https://hexstellar.com"},         ]},

Network accessline 70

{"action": "contact_support", "url": "https://hexstellar.com"},

Network accessline 132

"agent_fix": "Stop. Do not execute, replace, patch, or download the helper. Ask the operator for the official "                      "signed artifact and re-run setup with its explicit path.",         "next_actions": [{"action": "contact_en

Network accessline 133

"signed artifact and re-run setup with its explicit path.",         "next_actions": [{"action": "contact_enterprise_support", "url": "https://hexstellar.com"}]},     "HXS_ENTERPRISE_KEY_INVALID": {

Network accessline 134

"next_actions": [{"action": "contact_enterprise_support", "url": "https://hexstellar.com"}]},

Network accessline 139

"agent_fix": "Do not retry or transform the key. Confirm it was not logged, then ask the human operator to "                      "contact the HexStellar team.",         "next_actions": [{"action": "contact_enterprise_support", "url": "http

Network accessline 140

"contact the HexStellar team.",         "next_actions": [{"action": "contact_enterprise_support", "url": "https://hexstellar.com",                           "human_approval_required": True}]},

Network accessline 141

"next_actions": [{"action": "contact_enterprise_support", "url": "https://hexstellar.com",

Network accessline 147

"client version to the operator; never include a license key or device evidence.",         "next_actions": [{"action": "check_status", "command": ["hexstellar", "enterprise", "status"]},                          {"action": "contact_enterpri

Network accessline 148

"next_actions": [{"action": "check_status", "command": ["hexstellar", "enterprise", "status"]},                          {"action": "contact_enterprise_support", "url": "https://hexstellar.com"}]}, }

Network accessline 149

{"action": "contact_enterprise_support", "url": "https://hexstellar.com"}]},

`hexstellar/_hxsb.py`

Executable scriptline 1
```
Executable file
```

Network accessline 87

headers["Accept-Encoding"] = "gzip"     headers["X-Request-Id"] = uuid.uuid4().hex     req = urllib.request.Request(url, data=body, headers=headers, method="POST")

Network accessline 88

headers["X-Request-Id"] = uuid.uuid4().hex     req = urllib.request.Request(url, data=body, headers=headers, method="POST")     return _http_roundtrip(req, timeout)

Network accessline 89

req = urllib.request.Request(url, data=body, headers=headers, method="POST")

`hexstellar/_idempotency.py`

Executable scriptline 1
```
Executable file
```

`hexstellar/_jobs.py`

Executable scriptline 1
```
Executable file
```

`hexstellar/_manifest.py`

Executable scriptline 1
```
Executable file
```

Network accessline 127

if cached:         headers["If-None-Match"] = cached["etag"]     req = urllib.request.Request(_api_url() + "/api/v1/capabilities", headers=headers)

Network accessline 128

headers["If-None-Match"] = cached["etag"]     req = urllib.request.Request(_api_url() + "/api/v1/capabilities", headers=headers)     try:

Network accessline 129

req = urllib.request.Request(_api_url() + "/api/v1/capabilities", headers=headers)

Network accessline 194

def _fetch_text(url, timeout=3, accept="text/markdown, text/plain", max_bytes=_MAX_PUBLIC_DOCUMENT_BYTES):     req = urllib.request.Request(url, headers={"User-Agent": "hexstellar-cli/" + VERSION, "Accept": accept})

Network accessline 195

req = urllib.request.Request(url, headers={"User-Agent": "hexstellar-cli/" + VERSION, "Accept": accept})

`hexstellar/_meta.py`

Executable scriptline 1
```
Executable file
```
Access to secretsline 18
```
[Credential-related source omitted]
```

Network accessline 34

"output": {"format": "json", "errors": "RFC 9457 problem+json", "python_api_raises_on_remote_fault": False}, } DEFAULT_URL = "https://api.hexstellar.com"

Network accessline 35

} DEFAULT_URL = "https://api.hexstellar.com" DEFAULT_DOCS_URL = "https://docs.hexstellar.com"

Network accessline 36

DEFAULT_URL = "https://api.hexstellar.com"

Network accessline 37

DEFAULT_DOCS_URL = "https://docs.hexstellar.com"

Access to secretsline 56
```
[Credential-related source omitted]
```
Access to secretsline 57
```
[Credential-related source omitted]
```
Access to secretsline 74
```
[Credential-related source omitted]
```

`hexstellar/_output.py`

Executable scriptline 1
```
Executable file
```

`hexstellar/_problem.py`

Executable scriptline 1
```
Executable file
```

`hexstellar/_reporting.py`

Executable scriptline 1
```
Executable file
```
Access to secretsline 17
```
[Credential-related source omitted]
```
Access to secretsline 23
```
[Credential-related source omitted]
```

`hexstellar/_storage.py`

Executable scriptline 1
```
Executable file
```

Network accessline 60

try:             with open(path, "rb") as f:                 req = urllib.request.Request(upload_url, data=f, method="PUT", headers=put_headers)

Network accessline 61

with open(path, "rb") as f:                 req = urllib.request.Request(upload_url, data=f, method="PUT", headers=put_headers)                 with _open_url(req, timeout=max(600, size // (512 * 1024)), redirect_policy="none") as resp:

Network accessline 62

req = urllib.request.Request(upload_url, data=f, method="PUT", headers=put_headers)

`hexstellar/_transport.py`

Executable scriptline 1
```
Executable file
```
Access to secretsline 57
```
[Credential-related source omitted]
```

Network accessline 134

if len(value) <= 512 and "\r" not in value and "\n" not in value:             headers[str(name)] = value     req = urllib.request.Request(url, data=data, headers=headers, method=method)

Network accessline 135

headers[str(name)] = value     req = urllib.request.Request(url, data=data, headers=headers, method=method)     return _http_roundtrip(req, timeout, include_headers=include_headers)

Network accessline 136

req = urllib.request.Request(url, data=data, headers=headers, method=method)

Network accessline 271

redirected_method = "GET" if code in (301, 302, 303) else req.method         redirected_data = None if redirected_method == "GET" else req.data         redirected = urllib.request.Request(target, data=redirected_data, headers=safe_headers,

Network accessline 272

redirected_data = None if redirected_method == "GET" else req.data         redirected = urllib.request.Request(target, data=redirected_data, headers=safe_headers,                                             origin_req_host=req.origin_req_ho

Network accessline 273

redirected = urllib.request.Request(target, data=redirected_data, headers=safe_headers,

Network accessline 323

# Unknown recovery verbs remain display-only. Shell/curl strings are never executable response fields.

`hexstellar/api.py`

Executable scriptline 1
```
Executable file
```

Network accessline 42

host = u.hostname or "api.hexstellar.com"         port = u.port or (80 if u.scheme == "http" else 443)         s = socket.create_connection((host, port), timeout=timeout)

Network accessline 43

port = u.port or (80 if u.scheme == "http" else 443)         s = socket.create_connection((host, port), timeout=timeout)         s.close()

Network accessline 44

s = socket.create_connection((host, port), timeout=timeout)

Network accessline 221

elif fmt == "mcp":             out.append({"name": s["name"], "description": s["description"],                         "inputSchema": dict(s["schema"], **{"$schema": "https://json-schema.org/draft/2020-12/schema"}),

Network accessline 222

out.append({"name": s["name"], "description": s["description"],                         "inputSchema": dict(s["schema"], **{"$schema": "https://json-schema.org/draft/2020-12/schema"}),                         "annotations": {"readOnlyHint":

Network accessline 223

"inputSchema": dict(s["schema"], **{"$schema": "https://json-schema.org/draft/2020-12/schema"}),

Access to secretsline 254
```
[Credential-related source omitted]
```

`hexstellar/cli.py`

Executable scriptline 1
```
Executable file
```
Access to secretsline 97
```
[Credential-related source omitted]
```
Access to secretsline 215
```
[Credential-related source omitted]
```
Access to secretsline 479
```
[Credential-related source omitted]
```
Access to secretsline 480
```
[Credential-related source omitted]
```
Access to secretsline 482
```
[Credential-related source omitted]
```

`hexstellar/commands/init.py`

Executable scriptline 1
```
Executable file
```

`hexstellar/commands/account.py`

Executable scriptline 1
```
Executable file
```
Access to secretsline 30
```
[Credential-related source omitted]
```
Access to secretsline 38
```
[Credential-related source omitted]
```
Access to secretsline 107
```
[Credential-related source omitted]
```
Access to secretsline 108
```
[Credential-related source omitted]
```

Network accessline 117

if len(key) < 8 or any(c.isspace() for c in key):         die("HXS_INVALID_INPUT", "that does not look like an API key (too short or contains whitespace).", EXIT_VALIDATION, fmt,             help="Re-copy the key from https://hexstellar.com

Network accessline 118

die("HXS_INVALID_INPUT", "that does not look like an API key (too short or contains whitespace).", EXIT_VALIDATION, fmt,             help="Re-copy the key from https://hexstellar.com (no spaces or line breaks) and run `hexstellar login --ke

Network accessline 119

help="Re-copy the key from https://hexstellar.com (no spaces or line breaks) and run `hexstellar login --key <KEY>` again.")

Access to secretsline 123
```
[Credential-related source omitted]
```
Access to secretsline 143
```
[Credential-related source omitted]
```

Network accessline 164

print("HexStellar CLI setup")     print(f"  config file : {p} (written 0600)")     print(f"  service URL : {cfg.get('api_url') or _env('API_URL') or 'https://api.hexstellar.com (default)'}")

Network accessline 165

print(f"  config file : {p} (written 0600)")     print(f"  service URL : {cfg.get('api_url') or _env('API_URL') or 'https://api.hexstellar.com (default)'}")     print(f"  API key     : {'configured' if cfg.get('api_key') or _env('API_KEY')

Network accessline 166

print(f"  service URL : {cfg.get('api_url') or _env('API_URL') or 'https://api.hexstellar.com (default)'}")

Access to secretsline 167
```
[Credential-related source omitted]
```

Network accessline 213

obj,             [{"action": "inspect_registration_error", "fields": ["code", "detail", "errors"]},              {"action": "contact_support", "url": "https://hexstellar.com"}],

Network accessline 214

[{"action": "inspect_registration_error", "fields": ["code", "detail", "errors"]},              {"action": "contact_support", "url": "https://hexstellar.com"}],             "Read the registration error fields, repair only the rejected field

Network accessline 215

{"action": "contact_support", "url": "https://hexstellar.com"}],

Network accessline 231

EXIT_GENERAL, fmt,                 help="Do not register again. Contact support or use the account dashboard to issue a replacement key.",                 next_actions=[{"action": "contact_support", "url": "https://hexstellar.com"}])

Network accessline 232

help="Do not register again. Contact support or use the account dashboard to issue a replacement key.",                 next_actions=[{"action": "contact_support", "url": "https://hexstellar.com"}])         out.pop("token", None)

Network accessline 233

next_actions=[{"action": "contact_support", "url": "https://hexstellar.com"}])

Access to secretsline 341
```
[Credential-related source omitted]
```

`hexstellar/commands/agent.py`

Executable scriptline 1
```
Executable file
```

`hexstellar/commands/completion.py`

Executable scriptline 1
```
Executable file
```
Access to secretsline 110
```
[Credential-related source omitted]
```
Access to secretsline 114
```
[Credential-related source omitted]
```

`hexstellar/commands/docs.py`

Executable scriptline 1
```
Executable file
```

Network accessline 134

# Prefer the LIVE catalogue from the service (so examples added on the server show up without a reinstall), fall     # back to the copy bundled in this package when offline or the site is unreachable. --offline forces the bundled one.     #

Network accessline 136

# We pass ?client=<version> so a curl user gets a pre-filtered list too; the client-side filter below is the guarantee.

`hexstellar/commands/enterprise.py`

Executable scriptline 1
```
Executable file
```
Access to secretsline 221
```
[Credential-related source omitted]
```

Network accessline 483

"HexStellar team for Enterprise access.")             obj.setdefault("next_actions", [{"action": "contact_enterprise_support",                                               "url": "https://hexstellar.com",

Network accessline 484

obj.setdefault("next_actions", [{"action": "contact_enterprise_support",                                               "url": "https://hexstellar.com",                                               "human_approval_required": True}])

Network accessline 485
```
"url": "https://hexstellar.com",
```

`hexstellar/commands/info.py`

Executable scriptline 1
```
Executable file
```
Access to secretsline 61
```
[Credential-related source omitted]
```

Network accessline 63

"HEXSTELLAR_CANCEL_ON_INTERRUPT": "1 = Ctrl+C during a job wait cancels the job on the server (CI)",                 "HEXSTELLAR_DEBUG": "1 = show the Python traceback on an unexpected error (default: clean envelope)",                 "HEXS

Network accessline 64

"HEXSTELLAR_DEBUG": "1 = show the Python traceback on an unexpected error (default: clean envelope)",                 "HEXSTELLAR_API_URL": "service base URL (default https://api.hexstellar.com)",                 "HEXSTELLAR_FORMAT": "human

Network accessline 65

"HEXSTELLAR_API_URL": "service base URL (default https://api.hexstellar.com)",

Access to secretsline 250
```
[Credential-related source omitted]
```
Access to secretsline 258
```
[Credential-related source omitted]
```
Access to secretsline 308
```
[Credential-related source omitted]
```

`hexstellar/commands/jobs.py`

Executable scriptline 1
```
Executable file
```

`hexstellar/commands/mcp.py`

Executable scriptline 1
```
Executable file
```

`hexstellar/commands/report.py`

Executable scriptline 1
```
Executable file
```

`hexstellar/commands/solve.py`

Executable scriptline 1
```
Executable file
```
Access to secretsline 57
```
[Credential-related source omitted]
```

`hexstellar/commands/verify.py`

Executable scriptline 1
```
Executable file
```

`hexstellar/welcome.py`

Executable scriptline 1
```
Executable file
```
Access to secretsline 125
```
[Credential-related source omitted]
```

`llms.txt`

Network accessline 109

2. `command not found`, version `0.0.1` (a name-reservation placeholder), or no pip in your sandbox?    **Skip pip entirely — the pure-HTTP path needs nothing installed and is always live:**    `curl -s https://api.hexstellar.com/api/v1/cap

Network accessline 110

**Skip pip entirely — the pure-HTTP path needs nothing installed and is always live:**    `curl -s https://api.hexstellar.com/api/v1/capabilities` (native API-origin JSON manifest) →    `GET /api/v1/sandbox` (free token) → `POST /api/v1/ana

Network accessline 111

`curl -s https://api.hexstellar.com/api/v1/capabilities` (native API-origin JSON manifest) →

Network accessline 127

- **Air-gapped sandbox (no network egress)?** `hexstellar.demo()` / `hexstellar demo` still succeeds: it returns   a bundled, PRECOMPUTED, engine-verified result (honestly labeled — a genuine prior answer, never a simulation)   plus a ready

Network accessline 128

a bundled, PRECOMPUTED, engine-verified result (honestly labeled — a genuine prior answer, never a simulation)   plus a ready-to-paste curl your human can run for the live moment. - **Bigger than the sandbox cap (N > 50000)?** The service a

Network accessline 129

plus a ready-to-paste curl your human can run for the live moment.

Network accessline 177

# API (with the researcher's key). Raw HTTP carries the constant "tag" explicitly — the CLI and the Python # client fill it for you, but curl has no client to do it.

Network accessline 178

# client fill it for you, but curl has no client to do it.

Network accessline 179
```
[Credential-related source omitted]
```
Access to secretsline 179
```
[Credential-related source omitted]
```
Access to secretsline 180
```
[Credential-related source omitted]
```

Network accessline 205

- Live catalogue (no auth): `GET https://api.hexstellar.com/api/v1/examples` · one example:

Network accessline 206

`GET https://api.hexstellar.com/api/v1/examples/{id}` — metadata + runnable `problem` + verified `expected`.

Network accessline 207

- CLI: `hexstellar examples` / `hexstellar example <id> [--full]` · Python: `hexstellar.examples()`. - Every example with its problem JSON, expected answer and encoding recipe, on one page:   https://docs.hexstellar.com/examples/

Network accessline 208

- Every example with its problem JSON, expected answer and encoding recipe, on one page:   https://docs.hexstellar.com/examples/ - AI-fetcher-friendly formats: the whole catalogue as one markdown file at

Network accessline 209
```
https://docs.hexstellar.com/examples/
```

Network accessline 211

https://docs.hexstellar.com/examples/examples.md (index as JSON: /examples/index.json).

`pyproject.toml`

Network accessline 59

# ONLY real, live URLs belong here — a dead link costs more trust than a missing one. [project.urls] Homepage = "https://hexstellar.com"

Network accessline 60

[project.urls] Homepage = "https://hexstellar.com" Documentation = "https://docs.hexstellar.com"

Network accessline 61
```
Homepage = "https://hexstellar.com"
```

Network accessline 62

Documentation = "https://docs.hexstellar.com"

Network accessline 63

"Agent contract" = "https://api.hexstellar.com/.well-known/hexstellar-agent.json"

Network accessline 64

"Machine docs (llms.txt)" = "https://docs.hexstellar.com/llms.txt"

Network accessline 65

Changelog = "https://docs.hexstellar.com/CHANGELOG.md"

Network accessline 66

"Live playground" = "https://labs.hexstellar.com"

Network accessline 67

"Service status" = "https://status.hexstellar.com"

Network accessline 68

Source = "https://github.com/brayonpi/hexstellar"

Network accessline 69

Issues = "https://github.com/brayonpi/hexstellar/issues"

How the signals fit together

Facts from a static read of the files at the pinned commit. They describe what the code does, not why.

Some files could not be read; the facts below still hold.

Signal confidence: 8 facts

Network access in prose of documentationREADME.md:171Low confidence
Access to secrets in code of documentation: a variable, placeholder or call, not a stored valueREADME.md:262Low confidence
Network access in prose of documentationREADME.md:473Low confidence
Network access in prose of documentationREADME.md:474Low confidence
Network access in prose of documentationREADME.md:479Low confidence
Network access in prose of documentationREADME.md:496Low confidence
Network access in prose of documentationREADME.md:512Low confidence
Network access in prose of the SKILL.mdSKILL.md:150Low confidence

Works with

Agent compatibility, from the files in this repository
Agent	Status	Evidence	Install to
Claude Code	Compatible	Standard SKILL.md SKILL.md	`.claude/skills/<skill-name>/`
Codex	Native	Manifest AGENTS.md	`.agents/skills/<skill-name>/`
Cursor	Compatible	Standard SKILL.md SKILL.md	`.cursor/skills/<skill-name>/`
Gemini CLI	Compatible	Standard SKILL.md SKILL.md	`.gemini/skills/<skill-name>/`
GitHub Copilot	Native	Manifest .github/copilot-instructions.md	`.github/skills/<skill-name>/`
OpenCode	Compatible	Standard SKILL.md SKILL.md	`.opencode/skills/<skill-name>/`

Native The repository ships a manifest, folder or frontmatter field for this agent.
Compatible A standard SKILL.md that this agent can read.
Unknown No evidence either way.

Derived automatically from paths, manifests and frontmatter. Not tested on each agent.

Explore alternatives and comparisons

Add this badge to your README

It updates every night and links to this page.

[![brayonpi/hexstellar on hotskills](https://hotskills.dev/badge/brayonpi-hexstellar.svg)](https://hotskills.dev/skill/brayonpi-hexstellar/)

brayonpi/hexstellar

History

SKILL.md

Share this page

Heat

Stars over time

Individual skills in this repository

How it works

hexstellar

Frontmatter

SKILL.md

Reference documents

The playbook

Scripts executed separately

Files

Skills included

Repository facts

Rank over the last 12 weeks

Before you install

.github/workflows/ci.yml

.github/workflows/publish.yml

AGENTS.md

AGENT_SPEC.md

AI_MANIFEST.json

AI_PROMPT_TEMPLATE.md

CHANGELOG.md

CITATION.cff

HXSB_FORMAT.md

LICENSE

README.md

SECURITY.md

SKILL.md

SUPPORT.md

enterprise-runtime.json

examples/infra_fault_domain_split.json

examples/robotics_cell_layout.json

hexstellar/__init__.py

hexstellar/__main__.py

hexstellar/_config.py

hexstellar/_errors.py

hexstellar/_hxsb.py

hexstellar/_idempotency.py

hexstellar/_jobs.py

hexstellar/_manifest.py

hexstellar/_meta.py

hexstellar/_output.py

hexstellar/_problem.py

hexstellar/_reporting.py

hexstellar/_storage.py

hexstellar/_transport.py

hexstellar/api.py

hexstellar/cli.py

hexstellar/commands/__init__.py

hexstellar/commands/account.py

hexstellar/commands/agent.py

hexstellar/commands/completion.py

hexstellar/commands/docs.py

hexstellar/commands/enterprise.py

hexstellar/commands/info.py

hexstellar/commands/jobs.py

hexstellar/commands/mcp.py

hexstellar/commands/report.py

hexstellar/commands/solve.py

hexstellar/commands/verify.py

hexstellar/welcome.py

llms.txt

pyproject.toml

How the signals fit together

Works with

You might also use

mattpocock/skills

obra/superpowers

NousResearch/hermes-agent

multica-ai/andrej-karpathy-skills

anthropics/skills

DietrichGebert/ponytail

Explore alternatives and comparisons

Add this badge to your README

`SKILL.md`

`.github/workflows/ci.yml`

`.github/workflows/publish.yml`

`AGENTS.md`

`AGENT_SPEC.md`

`AI_MANIFEST.json`

`AI_PROMPT_TEMPLATE.md`

`CHANGELOG.md`

`CITATION.cff`

`HXSB_FORMAT.md`

`LICENSE`

`README.md`

`SECURITY.md`

`SKILL.md`

`SUPPORT.md`

`enterprise-runtime.json`

`examples/infra_fault_domain_split.json`

`examples/robotics_cell_layout.json`

`hexstellar/init.py`

`hexstellar/main.py`

`hexstellar/_config.py`

`hexstellar/_errors.py`

`hexstellar/_hxsb.py`

`hexstellar/_idempotency.py`

`hexstellar/_jobs.py`

`hexstellar/_manifest.py`

`hexstellar/_meta.py`

`hexstellar/_output.py`

`hexstellar/_problem.py`

`hexstellar/_reporting.py`

`hexstellar/_storage.py`

`hexstellar/_transport.py`

`hexstellar/api.py`

`hexstellar/cli.py`

`hexstellar/commands/init.py`

`hexstellar/commands/account.py`

`hexstellar/commands/agent.py`

`hexstellar/commands/completion.py`

`hexstellar/commands/docs.py`

`hexstellar/commands/enterprise.py`

`hexstellar/commands/info.py`

`hexstellar/commands/jobs.py`

`hexstellar/commands/mcp.py`

`hexstellar/commands/report.py`

`hexstellar/commands/solve.py`

`hexstellar/commands/verify.py`

`hexstellar/welcome.py`

`llms.txt`

`pyproject.toml`