JevCompass v0.1.16

JevCompass gives Codex Desktop and CLI short, nonblocking suggestions from tools and skills available in the user's setup. The default installation remains two advisory hooks.

What's new

• When a recommended skill fits the task, the advice asks Codex to read its SKILL.md before drafting or editing; unrelated skills remain optional and skipped.
• jevcompass doctor now distinguishes hook metrics by Codex profile, so an isolated profile cannot inherit a false invocation claim from another profile.
• jevcompass skills install offers two explicitly opt-in, experimental coding skills. No skills are installed by the default hook setup.

Install: pipx install jevcompass==0.1.16, then jevcompass install --dry-run, jevcompass install, and jevcompass doctor. Review and trust the hooks in Codex /hooks, then start a fresh session. Read the bundled skill files before opting in with jevcompass skills install.

A synthetic CLI pair observed one relevant skill read, but blinded answer quality tied 6/7. No speed or quality improvement is established. Desktop prompt delivery and macOS runtime remain separate validation work. JevCompass is licensed Apache-2.0.

Exact source commit: 5ef0fb6ecb9ab6e8778d2c69fd4a38420d40c7f3. Its clean archive passed 254 Python 3.11 tests, wheel/sdist content audit, and isolated pipx wheel installation with doctor.

JevCompass v0.1.15

JevCompass v0.1.15

This patch narrows security-specific skill suggestions: an ordinary code review no longer offers security-requirement-extraction solely because it matches the broad software domain. Explicit security, authentication, and signed-webhook tasks can still receive it. The signal is checked locally; task text is never sent to Jev. Manual recommend --domain security remains available.

The default installation has two nonblocking advisory hooks. Agent-spawn advice remains opt-in. Required project instructions and tests remain authoritative. This release changes candidate relevance; it does not establish faster task completion or higher task quality. See PILOT.md for the current evidence limits.

Source tag: v0.1.15 at d3214509ecfa997fe36b40290a4931373ae1994b.

JevCompass v0.1.14

JevCompass v0.1.14

This release respects installed skill MCP prerequisites during candidate discovery (PR #40) and adds optional task-aware advice when Codex creates an agent (PR #42). The default installation still registers only UserPromptSubmit and SubagentStart. The extra hook is matched to agent creation only and never gates shell, Git, Helm or network commands.

Download the v0.1.14 wheel from GitHub releases, verify its SHA-256 against the asset digest, then run:

pipx install ./jevcompass-0.1.14-py3-none-any.whl
jevcompass install --dry-run
jevcompass install
jevcompass doctor

To try the experimental spawn advisor, run jevcompass install --spawn-advice, review and trust the new entry in Codex /hooks, and start a fresh session. jevcompass install --disable-spawn-advice removes only that entry. The installer backs up an existing hooks.json when it changes it and preserves unrelated smem hooks.

One isolated CLI source-checkout experiment confirmed that the child saw an advice ID before its first tool when the host encoded the message and supplied a descriptive task title. It has not established skill use, improved outcomes, fresh Desktop delivery or macOS compatibility. The C05 equal-environment planning pair (PR #41) tied 6/7 on blind scores and showed no speed gain. PyPI publication is separate. JevCompass remains Apache-2.0 licensed. Previous release: v0.1.13.

Release verification

The annotated tag peels to 7e44137f3471532dfbf74d7a61c0e8946a58062f. PR #43 passed hosted Python CI at its exact head. A clean archive of the merged commit passed 224 Python 3.11 tests; the wheel and sdist passed the distribution-content/privacy audit. An isolated pipx Python 3.11 install confirmed the default two hooks, reversible opt-in spawn registration, preserved unrelated smem entries, and doctor PASS. In a clean synthetic CLI session using that wheel, the child context contained a spawn-advice ID before its first tool and the session exited 0; the child did not repeat the ID before that first tool. An earlier installed-wheel child repeated its ID before its first tool, but its parent timed out due to an invalid synthetic smem audit test hook, which was removed before the clean rerun. Neither check proves recommendation use or productivity gain.

SHA-256 (verify your download):

• jevcompass-0.1.14-py3-none-any.whl: edd405e752544476ac67efc112eb45e8cb47f9eafab93f715d1b1fc3e9a53c33
• jevcompass-0.1.14.tar.gz: 8d206b3530c08531eff73557d9c02f26d22b08b3fd83c161a9813a1b36b6bee0

JevCompass v0.1.13

JevCompass v0.1.13

Skill advice now includes concise catalog conditions for when to use or skip a suggested skill. The agent is prompted to inspect task scope before opening one. If these conditions would exceed the advisory size limit, JevCompass keeps the shorter bounded advice. The two hooks remain optional and nonblocking; routine shell and Git commands stay outside them.

Synthetic Codex CLI checks confirmed a remote Jev choice and advice ID reaching an agent before its first tool. Three local-build review pairs had no candidate skill read before source inspection, but source-read times were mixed. These observations do not establish a productivity or quality improvement. See pilot evidence and limitations.

Install from these assets

Download jevcompass-0.1.13-py3-none-any.whl, verify SHA-256 against the asset digest below, then:

pipx install ./jevcompass-0.1.13-py3-none-any.whl
jevcompass install --dry-run
jevcompass install
jevcompass doctor

Review and trust the two advisory hooks in Codex /hooks, then start a fresh session. Existing users should follow pipx replacement instructions for a locally downloaded wheel. JevCompass is Apache-2.0 licensed. macOS runtime, fresh Desktop prompt delivery, broad recommendation coverage and measured productivity gains remain unverified. PyPI publication is separate.

Asset SHA-256

• jevcompass-0.1.13-py3-none-any.whl: b88f97535d5c08b25d83119aea42a3d219230b064ca55ed174baaee66cee5a57
• jevcompass-0.1.13.tar.gz: 4dd8ee4853c3a11be66877d8302aeced8e26e2ea01bac28049e4793ab3da8168

JevCompass v0.1.12

JevCompass v0.1.12

This release adds focused setup advice for users configuring Codex Desktop and CLI. Explicit hook, settings, and skill setup requests can suggest the installed official openai-docs skill. The advisor excludes general office-document tooling from that category and stays silent when the skill is unavailable. Everyday shell and Git commands remain outside JevCompass's hooks.

A synthetic Codex CLI 0.155.1 session confirmed that this advice reached the agent before its first tool; the corresponding local hook took 2.75 ms. A current Desktop explorer negative control showed that the hook ran and intentionally stayed silent when only the generic shell was available. These are delivery and abstention checks, not measured speed or quality improvements. See PILOT.md for the evidence and limits.

Install from the GitHub release

Download the v0.1.12 wheel from the GitHub releases page, compare its SHA-256 with GitHub's asset digest, then run:

pipx install ./jevcompass-0.1.12-py3-none-any.whl
jevcompass install --dry-run
jevcompass install
jevcompass doctor

Review and trust the two advisory hooks in Codex /hooks, then start a fresh session. Existing installations can use pipx upgrade jevcompass when installed from an upgradeable source; otherwise install the verified wheel with pipx following its replacement instructions. The installer backs up hooks.json when it modifies it.

JevCompass is Apache-2.0 licensed. This GitHub release does not establish macOS runtime behavior, fresh Desktop prompt delivery, broad advice coverage, or measured productivity gains. PyPI publication is a separate step. Previous release: v0.1.11.

JevCompass v0.1.11

JevCompass v0.1.11

Public, Apache-2.0-licensed GitHub release for Codex Desktop and CLI. JevCompass discovers reviewed local tools and skills, offers explicit recommendations, and installs two non-blocking advisory hooks. Optional Jev ranking uses OpenRouter Decisions API with allowlisted metadata; a keyless local shortlist is available when appropriate.

What's included

• Public source onboarding with a real keyless example and a fresh-session advice verification guide.
• A history category for explicit repository provenance questions.
• Accurate jevcompass --version and text doctor version reporting.
• Apache-2.0 SPDX metadata and the full license in wheel and sdist.
• One hosted Python 3.11 PR test job, with no local runner requirement.

Install

Download the wheel below, verify its SHA-256 against the digest shown by GitHub, and run pipx install ./jevcompass-0.1.11-py3-none-any.whl. Then run jevcompass install --dry-run, jevcompass install, and jevcompass doctor. Review the two hook registrations in Codex /hooks and start a fresh session. The source checkout path is in the README.

Verification

• Source/tag commit: 1e71eee5e3f53e52414aa63ffce72eb67a14edb2.
• Hosted PR #9 Python 3.11: 179 tests passed; local Python 3.11 and 3.14: 179 tests each.
• Clean wheel and sdist passed tools/check_distribution.py; isolated pipx installation and keyless recommendation, install dry-run, install, and doctor passed.
• Wheel SHA-256: b7ffba2547ef457a4aa9f288afb7d612763895490811c25fe29108619c27c3ad.
• Sdist SHA-256: 124695b004b0975cc90626a8cf735cc5e207bde9969cd2ff1c4e525fc75da396.

macOS runtime, broad hook delivery, and measurable task benefit remain unverified. This release is on GitHub; no PyPI publication is claimed.

JevCompass v0.1.10

JevCompass v0.1.10

JevCompass provides optional, non-blocking tool and skill advice for Codex Desktop and CLI. This invited-user release adds separate recent invocation status for each hook in doctor and repository-only synthetic delivery probes for prompt and subagent paths. These diagnostics do not establish agent-visible delivery or measured productivity gain.

Release tag target SHA: recorded in TASKS.md after committing and verifying the release artifacts.

Install for invited users

Download jevcompass-0.1.10-py3-none-any.whl from the private v0.1.10 GitHub release, verify its SHA-256 against GitHub's asset digest, then run:

pipx install ./jevcompass-0.1.10-py3-none-any.whl
jevcompass install
jevcompass doctor

Review and trust the two advisory hooks in Codex /hooks, then start a fresh session. Access to the private repository is required. No PyPI or TestPyPI package has been published.

Verified scope

Linux CPython 3.11–3.14 test, packaging, artifact-content, isolated pipx install, and doctor results are recorded in TASKS.md for the tagged release commit. The isolated install checks the released wheel without modifying the active pipx environment or Codex hook configuration.

The latest GitHub CI run failed before any runner steps; its job arrays are empty, and GitHub annotated the run with failed recent account payments or a spending limit. The exact account-side cause is unverified. macOS runtime and current Desktop prompt delivery remain unverified. Recent subagent probes did not observe a child or receipt; that result is inconclusive about real delivery. Broader usefulness and a productivity or quality benefit are not established; previous synthetic CLI quality comparisons tied. Advice does not grant permissions, install skills, or replace required tests.

JevCompass v0.1.9

JevCompass v0.1.9

Private invited-user release. The repository remains private. This release makes no stable-status or productivity-benefit claim.

Verified

• Release tag targets source commit 5f04e2f.
• 171 tests passed on Linux CPython 3.11, 3.12, 3.13, and 3.14.
• Wheel and sdist passed distribution freshness and content checks.
• Isolated CPython 3.14 pipx install, hook installation, and doctor passed.
• Wheel SHA-256: 2e695ae8dde557ae39c2481ab3524ef40e37695ff522abfd16887989723053e4
• Source archive SHA-256: c74b9bd2548ad05042ae4f0b999fde7e861353da580d32159086d7a0801f6c07

Limits

GitHub Actions jobs did not reach runner steps because of the account billing gate. macOS runtime and fresh Desktop prompt delivery remain unverified. Prior synthetic CLI quality comparisons tied, so broader usefulness and benefit are not established. JevCompass advice does not grant permissions or replace required checks.

No PyPI or TestPyPI upload was made.

JevCompass v0.1.8

JevCompass v0.1.8

JevCompass adds optional tool and skill advice to Codex Desktop and CLI. It uses two advisory hooks, UserPromptSubmit and SubagentStart, and never gates ordinary commands.

Included

• A locally curated catalog of tools and installed skills, with availability checks and a small shortlist.
• Optional ranking through the OpenRouter Decisions API using Jev. The advisor sends coarse task and candidate metadata; it does not send raw prompts, code, diffs, or memory contents.
• jevcompass install, doctor, and explicit recommend commands.
• Faster hook startup for skipped tasks through lazy imports.

Install for invited users

Download the wheel from this private release, verify its SHA-256 against the asset digest, then run:

pipx install ./jevcompass-0.1.8-py3-none-any.whl
jevcompass install
jevcompass doctor

Review the two new hooks in Codex /hooks and start a fresh session. Repository access is required to download the wheel. No PyPI package has been published.

Verified scope

The 171-test suite passed on Linux CPython 3.11–3.14. The wheel and source archive passed content checks, and an isolated pipx install plus doctor passed. In a later fresh Codex CLI 0.155.1 session with the installed v0.1.8 wheel, a synthetic read-only task reported local advice ID a14d8368 and the suggested exec_command/git IDs before its first tool. Four paired synthetic CLI tasks tied on task quality, so a productivity or quality gain is not established.

GitHub-hosted checks did not run because the account's billing/spending-limit state stopped jobs before runner steps. macOS runtime and current Desktop prompt delivery still need direct host tests. The CLI proof above used a local fallback, not a paid Jev request. Advice does not grant permissions, install skills, or replace required tests.

JevCompass v0.1.7 private alpha

Private alpha; downloads are restricted to collaborators with repository access.

• The prompt hook now imports its hook handler directly, avoiding the CLI module on hook startup.
• Linux CPython 3.14.7 timing sample: 30 matched launches per case; skip median 99.38 to 83.07 ms, eligible keyless median 405.13 to 390.60 ms. Eligible p95 varied.
• All 170 unit tests pass locally on CPython 3.11.15, 3.12.13, 3.13.13, and 3.14.7. Built wheel and sdist pass distribution freshness and privacy checks; isolated pipx install, hook registration, doctor, and keyless recommendation smoke pass.
• Four fresh synthetic CLI pairs tied on task quality; improvement remains unproven.
• GitHub Actions failed before runner steps because of the account billing/spending-limit block. Hosted CI and macOS are unverified.
• No PyPI or TestPyPI upload.