Jossue AlcaláCreate · Build

AHP+ 1.4.1 · Command Atlas

Let context travel with the work.

AHP+ keeps what was done, what was checked, and what comes next inside the project. That lets you switch assistant, account, or computer without explaining everything again.

Install AHP+See real proof

1command to get started

6surfaces with adapters

Youauthorize what matters

00 / In one sentence

Conversation helps. The repository remembers.

AHP+ is not another chatbot. It is a continuity layer that turns important context into files that can be read, checked, and carried with the code.

TERMINAL

The operation happens here

The command returns reproducible output. That output can become evidence.

shell
npx ahp project verify . --strict

IDE / CHAT

You express intent here

The adapter translates the request to the CLI and the agent must show the result. Its words alone do not prove execution.

chat
Use $ahp to check this project. Do not edit.

01 / What it enables

Continuity you can inspect.

Version 1.4.1 expands the protocol without turning it into a black box. Every capability keeps an identifiable output, boundary, and authority.

01

The project remembers.

State, decisions, proof, and the next step live in .ahp/, beside the work they describe.

02

The handoff is checked.

A sealed handoff is inspected and only received when it matches the project and its Git boundary.

03

Assistants can converse.

Causal messages, read-only consultations, and shared rooms leave a durable trace.

04

Certainty is labelled.

VERIFIED is not the same as an inference. AHP+ preserves that difference so the team can decide better.

05

Identity travels encrypted.

Version 1.4.1 adds per-device identities, encrypted envelopes, and signed receipts for authorized transport.

06

The person stays in control.

AHP+ grants no permission to commit, push, merge, deploy, publish, pay, delete, or access secrets.

02 / Real proof

This project completed the path.

On September 12, 2026, we ran the CLI installed in jossue-portfolio, verified the repository, received a handoff from Claude, and replied inside a shared room.

EXECUTED VERSION

1.4.1CLI installed inside jossue-portfolio.

STRICT VERIFICATION

PASS21 files checked; 0 errors and 0 warnings.

HANDOFF

READYHOF-20260912-6BF37A9D

SHARED ROOM

LOCAL_CAPTUREDconv-room-20260912-c233f7d7

03 / Installation

One command to get started.

You need Git, Node.js 20 or newer, and at least one commit. setup pins the version, prepares .ahp/, installs the selected surfaces, and runs doctor plus verify --strict.

Open Terminal at the repository root. The same command installs and configures.

zsh
npx @jossuealcala/ahp-plus@1.4.1 setup .
npx ahp project check .

DEFAULT

Codex + Claude

setup installs both surfaces and their local identities.

terminal
npx @jossuealcala/ahp-plus@1.4.1 setup .

FOCUSED

Una plataforma

Limit the installation if you do not need every integration.

terminal
npx @jossuealcala/ahp-plus@1.4.1 setup . --platforms codex

04 / Daily use

Orient first. Act second.

Use the pulse when opening the project, switching assistants, or receiving work. It keeps you from deciding from a stale summary or the wrong repository.

terminal · all OS
npx ahp project check . --platform codex
npx ahp project status .
npx ahp session context . --format markdown --budget 8000

Read the output before editing. LOCAL_READY refers to this machine; REMOTE_READY requires continuity to be available on the remote.

05 / Atlas

Search by intent.

Do not memorize the CLI. Search for what you want to accomplish and copy the example. The syntax is the official AHP+ 1.4.1 grammar: category, action, target, and options.

41 commands visible

Start

Install and configure

Pins AHP+ 1.4.1, prepares .ahp/, Codex and Claude, creates local identities, and runs the initial checks.

terminal
npx @jossuealcala/ahp-plus@1.4.1 setup .

Start

Install for Codex only

Avoids integrations you will not use and keeps only the Codex surface.

terminal
npx @jossuealcala/ahp-plus@1.4.1 setup . --platforms codex

Start

View the official catalog

Lists the grammar and commands available in the installed version.

terminal
npx ahp catalog

Project

Recommended pulse

Summarizes project identity, structure, verification, readiness, and transport in one pass.

terminal
npx ahp project check . --platform codex

Project

Confirm the root

Shows which repository and .ahp/ folder it will use before writing.

terminal
npx ahp project root .

Project

Diagnose the installation

Checks identity, structure, and portability without altering the project.

terminal
npx ahp project doctor .

Project

Diagnose Git

Adds a reading of the host Git state to the diagnosis.

terminal
npx ahp project doctor . --diagnose-git

Project

Run a strict verification

Validates structure, references, integrity, and warnings.

terminal
npx ahp project verify . --strict

Project

See project status

Explains phase, Git state, locks, and portability.

terminal
npx ahp project status .

Project

Separate local from remote

Distinguishes being ready here from being ready to continue on another machine.

terminal
npx ahp project ready . --platform codex

Project

Accept the current commit

Deliberately confirms the canonical boundary after reviewing the diff; it does not commit or push.

terminal
npx ahp project state . --accept-head

Session

Read the context

Generates a bounded summary for a person or agent.

terminal
npx ahp session context . --format markdown --budget 8000

Session

Refresh the brief

Regenerates the summary stored inside the repository.

terminal
npx ahp session brief . --budget 8000

Session

Create a checkpoint

Stores where you stopped and the next verifiable action.

terminal
npx ahp session checkpoint . --summary "Límite validado" --next-action "Crear handoff"

Session

Review history

Lists checkpoints and handoffs for the session.

terminal
npx ahp session history .

Conversation

Send a causal message

Stores an operational message with a verifiable fingerprint inside the project.

terminal
npx ahp message send "Continúa desde el límite verificado" --from codex --to claude

Conversation

Read the inbox

Shows messages addressed to a platform.

terminal
npx ahp message inbox . --for claude

Conversation

Reply to a message

Links the reply to the event that originated it.

terminal
npx ahp message reply EVT-... "Recibido y verificado" --from claude

Conversation

Verify a fingerprint

Checks that an event has not changed since it was created.

terminal
npx ahp message verify EVT-... .

Conversation

Ask for a second opinion

Requests one read-only answer from Claude from Codex.

terminal
npx ahp agent ask claude "¿Qué riesgo ves en este cambio?" --from codex

Conversation

Open a room

Creates a durable conversation for participants in the same project.

terminal
npx ahp conversation open "Revisión de arquitectura" --participants codex,claude --from codex

Conversation

Send to the room

Adds a new event to a shared room.

terminal
npx ahp conversation send conv-... "Revisa el siguiente paso" --from codex --to claude

Conversation

Wait for a reply

Performs an explicit wait; it does not wake or write into another app’s native chat.

terminal
npx ahp conversation wait conv-... --for codex --timeout 60

Evidence

Store evidence

Records the observed result of a test or artifact.

terminal
npx ahp record add evidence . --title "Verificación local"

Evidence

Store a decision

Keeps an explicit, reviewable decision inside the project.

terminal
npx ahp record add decision . --title "Mantener autoridad humana"

Evidence

List active tasks

Shows only what still requires attention.

terminal
npx ahp record list task . --active

Evidence

Close a record

Closes a record with an explicit status; history is preserved.

terminal
npx ahp record close TASK-... . --status CLOSED

Continuity

Create the handoff

Seals the context needed to continue on another platform.

terminal
npx ahp handoff create . --from codex --to claude --summary "Continuar desde el límite validado"

Continuity

Inspect the handoff

Checks contents and integrity without accepting it yet.

terminal
npx ahp handoff inspect HOF-... .

Continuity

Receive the handoff

Accepts it only if it matches the project and its Git boundary.

terminal
npx ahp handoff receive HOF-... .

Continuity

Check transport

Checks whether continuity is available remotely; it does not run Git.

terminal
npx ahp sync check . --require-remote

Continuity

Reserve a scope

Publishes a cooperative lock so two agents do not overwrite the same area.

terminal
npx ahp lock acquire . --scope src/editor --owner codex

Continuity

Release the scope

Removes the cooperative lock when the work is done.

terminal
npx ahp lock release LOCK-... . --owner codex

Security

List identities

Shows the available local device identities.

terminal
npx ahp identity list .

Security

Verify an identity

Checks a device signing and encryption identity.

terminal
npx ahp identity verify DEV-... .

Security

Send encrypted over the network

Encrypts and signs an event for a specific device through an authorized hub.

terminal
npx ahp secure network send EVT-... --from-device DEV-... --to-device DEV-... --url HTTPS_URL --token-file FILE

Security

Receive encrypted

Downloads and opens messages addressed to a local identity.

terminal
npx ahp secure network receive --as-device DEV-... --url HTTPS_URL --token-file FILE

Security

Confirm with a receipt

Returns a receipt signed by the receiving device.

terminal
npx ahp secure network confirm --as-device DEV-... --url HTTPS_URL --token-file FILE

Integration

See platforms

Lists the adapters recognized by the installed version.

terminal
npx ahp adapter list

Integration

Preview adapters

Shows which files would be installed and detects conflicts, without writing.

terminal
npx ahp adapter install all .

Integration

Apply adapters

Installs surfaces for the selected assistants.

terminal
npx ahp adapter install all . --apply

06 / CHAT

Ask in human language.

The adapter is installed from the terminal. You can then express intent in chat; the agent must run the local CLI and show evidence.

IDE / APP

Cursor

Installs /ahp in Cursor. The adapter translates intent to the local CLI and must show real output.

In terminal

terminal
npx ahp adapter install cursor . --apply

Directly in chat

  • CHAT
    /ahp project check
  • CHAT
    /ahp session checkpoint summary="Validated boundary" next="Create handoff"
  • CHAT
    /ahp conversation inbox room=conv-... for=cursor
  • CHAT
    /ahp receive HOF-...

IDE / APP

OpenCode

Installs the same /ahp vocabulary in OpenCode.

In terminal

terminal
npx ahp adapter install opencode . --apply

Directly in chat

  • CHAT
    /ahp status
  • CHAT
    /ahp verify strict
  • CHAT
    /ahp handoff to claude

IDE / APP

Codex

Installs the $ahp skill and keeps the project contract in AGENTS.md.

In terminal

terminal
npx ahp adapter install codex . --apply

Directly in chat

  • CHAT
    Use $ahp to check this project and show project_id, commit, portability, locks, and next action. Do not edit files.
  • CHAT
    Use $ahp to ask Claude what risk it sees in this change, read-only.
  • CHAT
    Use $ahp to receive HOF-... and do not edit unless the outcome is READY.

IDE / APP

Claude Code

Connects CLAUDE.md with AHP_INSTRUCTIONS.md. It uses natural language, not its own slash command.

In terminal

terminal
npx ahp adapter install claude . --apply

Directly in chat

  • CHAT
    Use AHP+ to run the project pulse and show me the real output before continuing.
  • CHAT
    Use AHP+ to ask Codex for one read-only review and one response.
  • CHAT
    Receive HOF-... with AHP+ and stop if it requires reconciliation.

IDE / APP

ChatGPT / Mobile

With repository and terminal access it can run. If it only reads files, it must declare that limitation.

In terminal

terminal
npx ahp adapter install chatgpt . --apply

Directly in chat

  • CHAT
    Read AHP_INSTRUCTIONS.md. Run the start-up pulse and show me the real output.
  • CHAT
    If you have no terminal, use AHP_MOBILE.md and do not say you verified, tested, committed, or pushed.

IDE / APP

Cualquier otro agente

Installs provider-neutral instructions for any agent with repository access.

In terminal

terminal
npx ahp adapter install generic . --apply

Directly in chat

  • CHAT
    Follow this repository’s AHP+ instructions. Verify before writing and use confirmed Git state as the canonical source.
  • CHAT
    Show me the real evidence and wait for my authorization before any external action.

07 / Handoff

Switch assistants without starting over.

The handoff seals context and links it to the project. Git transports it, and a person authorizes every external action.

  1. 01

    Mark the boundary

    Save where you stopped and what should happen next.

    terminal
    npx ahp session checkpoint . --summary "Límite validado" --next-action "Crear handoff"
  2. 02

    Create the handoff

    Declare origin, destination, and summary. AHP+ seals it against changes.

    terminal
    npx ahp handoff create . --from codex --to claude --summary "Continuar desde el límite validado"
  3. 03

    Transport with authorization

    Review the diff and decide whether to commit and push. AHP+ neither runs nor authorizes Git.

  4. 04

    Inspect before receiving

    The receiver checks integrity, project, and Git boundary before editing.

    terminal
    npx ahp project verify . --strict
npx ahp handoff inspect HOF-... .
npx ahp handoff receive HOF-... .
npx ahp sync check . --require-remote

08 / Limits

AHP+ informs. You decide.

READY says continuity checks out. It does not mean there is permission to act. These actions always remain outside the protocol:

  • commit
  • push
  • pull
  • merge
  • publish
  • deploy
  • delete
  • payments
  • secrets
GitHubnpmView product case

Content checked against the CLI and documentation included in @jossuealcala/ahp-plus 1.4.1. Evidence on this page comes from an observed local run on September 12, 2026; it does not present external adoption as fact.