Publish status

Skill jrausercisco/trmnl-agent-bridge/plugins/trmnl-agent-bridge/skills/publish-status

Publish local agent status snapshots to TRMNL Private Plugin webhooks.

Install

npx -y skills add jrausercisco/trmnl-agent-bridge --skill publish-status

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Summarize the current Codex task into a privacy-safe TRMNL agent-status payload and publish or dry-run it with the trmnl-agent CLI.

SKILL.md

2.2 KB, 543 tokens by cl100k_base, as published. Nobody here has run it

Publish Status

Use this skill when the user asks Codex to publish, show, send, update, or dry-run the current task status on TRMNL.

Requirements

Use the agent-status.v1 payload shape.
Keep the payload short enough for an e-ink screen.
Do not include prompts, transcripts, raw logs, file contents, customer names, email/calendar content, webhook URLs, device IDs, API tokens, local secrets, or private message bodies.
Prefer source: "codex" for Codex-originated payloads.
Use trmnl-agent push --stdin --dry-run for previews or when the user did not clearly ask for a live push.
Use trmnl-agent push --stdin only when the user clearly asks to publish to TRMNL.

Payload Shape

{
  "schema_version": 1,
  "source": "codex",
  "title": "CODEX NOW",
  "state": "WATCH",
  "headline": "Short current signal",
  "detail": "One sentence of useful context.",
  "next": "Next action or latest meaningful event.",
  "signals": [
    "Tests: dry run",
    "Agent: active"
  ],
  "health": "Dry run OK",
  "updated": "HH:MM"
}

Allowed state values are CLEAR, WATCH, ACTION, BLOCKED, and FAIL.

Workflow

Decide the payload state:
- CLEAR: no attention needed.
- WATCH: progress or background activity worth tracking.
- ACTION: the user should look soon.
- BLOCKED: Codex cannot proceed without input.
- FAIL: a command, validation, push, or verification failed.
Create a compact JSON payload using only the allowed fields.
Inspect the JSON for secrets or private content before running the CLI.
Run the CLI:

trmnl-agent push --stdin --dry-run

For a live publish requested by the user:

trmnl-agent push --stdin

If trmnl-agent is not on PATH and the repository checkout is available, run from the repository root:

PYTHONPATH=src python3 -m trmnl_agent_bridge.cli push --stdin --dry-run

Output

Summarize whether the command was a dry-run or live push, whether validation passed, the payload state/headline, and any missing credential or webhook issue. Do not echo secret values.