Przejdź do treści
Biblioteka skilli
AI i agenci · Integracja z narzędziem

agenttrail

/agenttrail

Pokazuje w przeglądarce żywą mapę wieloagentowego buildu: nad którym komponentem planu pracuje który agent, co jest skończone, a co utknęło.

Repozytorium
aos ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
14.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
26
Skrypty
19
Komentarze HTML
1
Adresy URL w SKILL.md
1
Przestarzałość

Brak sygnałów. Repozytorium zmienione 14.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

Co sprawdzić przed instalacją
  • 19 skryptów w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.
  • SKILL.md zawiera komentarze HTML (1). Nie widać ich w podglądzie Markdown, a model je czyta.

Skrypty: bin/agenttrail.mjs, bin/ensure.mjs, bin/repoid.mjs, bin/trail-hub.mjs, lib/click.mjs, lib/code-stamp.mjs, lib/events.mjs, lib/gatepanel.mjs

Co robi i kiedy

Pokazuje w przeglądarce żywą mapę wieloagentowego buildu: nad którym komponentem planu pracuje który agent, co jest skończone, a co utknęło.

Wyzwalacze z opisu

live mapbuild boardwho is running now
Oryginalny opis (EN)

agenttrail: live map of a multi-agent build in the browser: which plan component is being worked on, by which agent or harness, what is done and what is stuck. Use when a multi-agent pipeline starts (/startcycle, /startcycle-graph, /teamwork-preview) or after a plan-canvas approve, when the user asks to see what the agents are doing ("live map", "build board", "who is running now"), or by yourself whenever a multi-agent run is under way — no user prompt needed.

Jak działa

  1. Start the map
  2. Ensure (auto-start)
  3. Plan convention
  4. Live agent events
  5. Stop
  6. Rules
Sekcje z nagłówków SKILL.md, w oryginale · 52 linii, 672 słów
Podgląd SKILL.md
---
name: agenttrail
description: >-
  agenttrail: live map of a multi-agent build in the browser: which plan component is being
  worked on, by which agent or harness, what is done and what is stuck. Use
  when a multi-agent pipeline starts (/startcycle, /startcycle-graph,
  /teamwork-preview) or after a plan-canvas approve, when the user asks to see
  what the agents are doing ("live map", "build board", "who is running now"),
  or by yourself whenever a multi-agent run is under way — no user prompt
  needed.
category: bdb-core
metadata:
  version: "0.2.0"
  origin: sodiumsun/agenttrail@e4ba2da
  license: MIT
---

<!-- Source: sodiumsun/agenttrail bin/agenttrail.mjs + public/index.html — MIT, see THIRD_PARTY_NOTICES.md -->

# agenttrail — live pipeline map

agenttrail serves a browser board that mirrors a multi-agent build in real time: which plan component is being worked on, by which agent or harness, what is done and what is stuck. It observes only — it never runs agents and never marks tasks done.

## Start the map

```bash
aos-trail . --plan production_artifacts/00_execution_plan.md --no-open
```

It prints the URL (default http://localhost:5330, next free port if taken). Open that URL for the user. If running inside AO (env var `AO_BROWSER_CAPABILITY` is set), run `ao preview <url>` so it shows in AO's Browser tab. Without a plan file, start it with just `aos-trail .` — it then shows file activity only.

## Ensure (auto-start)

```bash
aos-trail --ensure [--cwd <dir>] [--plan <file>] [--session <id>] [--json]
```

Starts the map detached if none runs for this repo (matched via `/whoami` `repoPath` on 127.0.0.1:5330-5344). `repoPath` is the repo's main checkout, so every git worktree of a repo finds the same map; the map shows each worktree as its own lane (branch and folder) and files hook events by their `cwd`. `/whoami` also lists `worktrees`, opens it at most once per session (state in `$TMPDIR/aos-trail-ensure/`), and always exits 0. Plan: `--plan`, else `production_artifacts/00_execution_plan.md`, else the single `production_artifacts/*/00_execution_plan.md`; it needs a `{#id}` marker. No open under `CI`, SSH, or headless Linux; with `AO_BROWSER_CAPABILITY` it runs `ao preview <url>`. `--json` prints `{url,started,opened,reason,plan,hint}`. Test overrides: `AOS_TRAIL_OPENER` (opener command), `AOS_TRAIL_PORTS=lo-hi` (probe range).

Lanes: main first, then at most 11 worktrees; the slots go to the most recently active ones (a lane with events in the last 10 min keeps its slot), and events from any further worktree of the repo are filed in one `other worktrees` lane, never in main. `/whoami` carries `protocol: 2`. `--ensure` replaces a daemon on this repo (or one of its worktrees) that lacks it: the new map starts first, then the old one is asked to quit via `POST /shutdown` (JSON body naming its own `repoPath`); a daemon that cannot (older ones have no such API) keeps running and `hint` says which port to stop. Two concurrent `--ensure` runs share a lock file in `$TMPDIR/aos-trail-ensure/`. `/setup` on a map with several lanes needs `{"lane": "<key>"}` and writes into that checkout.

## Plan convention

The plan file uses components and tasks:

- `## Plain-language name {#id}` = a component (5-9 per plan), stable ids
- under it optional lines: `needs: [id, id]`, `links: [id]`, `files: [src/**]`, `url: production_artifacts/00_architecture.html`
- tasks: `- [ ] Outcome {#task-id}`; mark `[~]` BEFORE starting, `[x]` when done, `[!]` when stuck, and add an indented `by: <agent>` line (claude, codex, agy, opencode)
- save the file immediately after each status change; never batch updates to the end
- Mermaid blocks and prose may stay in the file; the map ignores them.

## Live agent events

The AOS installer registers `.claude/hooks/trail-relay.mjs --agent <harness>` for Claude Code (PreToolUse, PostToolUse, SessionStart, Stop, SubagentStop), Antigravity and Codex (PreToolUse, Stop). The OpenCode plugin and mcsc (for the CLI workers it delegates to) post events directly. Events are fire-and-forget (300 ms cap) and never block a tool call; with no map running they are dropped.

**Automatic node link.** A dispatcher sets `AOS_TRAIL_NODE=<node-id>` and `AOS_TRAIL_PLAN=<plan-file>` when it starts a worker (`aos-acp --trail-node <id> --trail-plan <file>` does this). The relay stamps both onto every event, so the node is live on the map while the worker reports and is shown as touched, not done, after its Stop or SessionEnd. Interactive sessions: `aos-trail emit task.update --task <id> --status doing --plan <file>`.

A component's `url:` may be a path under `production_artifacts/` — the map serves that folder, so e.g. `url: production_artifacts/00_architecture.html` opens the archify diagram from the card.

## Stop

The daemon runs until its terminal/process ends; `aos-trail up` relaunches saved boards.

## Rules

- Never create a root `PLAN.md` in a user repo during an AOS pipeline — always point at the pipeline's plan with `--plan`.
- Never mark `[x]` without evidence in the code.
Pliki w paczce (26)
  • LICENSE 1 KB
  • SKILL.md 5 KB
  • bin/agenttrail.mjs 70 KB
  • bin/ensure.mjs 8 KB
  • bin/repoid.mjs 4 KB
  • bin/trail-hub.mjs 16 KB
  • lib/click.mjs 15 KB
  • lib/code-stamp.mjs 2 KB
  • lib/events.mjs 8 KB
  • lib/gatepanel.mjs 7 KB
  • lib/httpguard.mjs 2 KB
  • lib/hub-model.mjs 11 KB
  • lib/hub-state.mjs 2 KB
  • lib/identity.mjs 3 KB
  • lib/plan.mjs 4 KB
  • lib/sessions.mjs 7 KB
  • lib/shared-static.mjs 2 KB
  • lib/stale.mjs 3 KB
  • public/index.html 35 KB
  • public/hub/app.css 6 KB
  • public/hub/app.js 22 KB
  • public/hub/enroll.html 1 KB
  • public/hub/enroll.js 2 KB
  • public/hub/index.html 2 KB
  • public/shared/map.css 50 KB
  • public/shared/map.js 46 KB

Wersje

W bazie nie ma innych skilli o nazwie agenttrail.

Migawka bazy z 13.11.2026 · wersja paczki 4457b2d43c8e (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100startcycle
    Uruchamia liniowy pipeline budowy z wieloma agentami i przekazywaniem plików w production_artifacts/, po zatwierdzeniu planu z /bdbrainstorm lub /grill-me, bez stanu trwałego i pętli naprawczej.
  • 95startcycle-graph
    Uruchamia autonomiczny wieloagentowy potok budowania z trwałym stanem, pętlą poprawek po przeglądzie i automatyczną bramką jakości, przekazując pracę kolejnym rolom od architekta po wydanie.
  • 100agent-harness
    Prowadzi agenta w izolowanym środowisku agent-harness: odnajdywanie identyfikatora agenta i portów, zarządzanie stosem przez agent-cli.sh, weryfikacja i układ wieloagentowego developmentu.
  • 90teamwork
    Prowadzi dużą budowę repozytorium wieloma agentami: najpierw wywiad z zatwierdzeniem zakresu, potem autonomiczne etapy z równoległymi wykonawcami.
  • 90multi-agent-systems
    Układa architekturę systemu wieloagentowego: dobór agentów, podział ról i sposób koordynacji.
  • 90live
    Pokazuje stan uruchomionych sesji i agentów, czyli co działa i co wymaga uwagi, gdy użytkownik pyta o ich status.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.