Imported from eeemzs/aops (
assets/skills/aops-cli-view/SKILL.md). Install upstream withnpx skills add eeemzs/aops --skill aops-cli-view. Copyright stays with the author.
AOPS CLI View
aops-cli view ... is a read-only presentation cockpit. Most commands are local-cache and read local .aops/**/*.md files. Explicit hosted commands (hosted-projects, hosted-inventory) call hosted list APIs for inspection only. View never syncs, refreshes mirrors, writes cache/index files, or runs domain mutations. Default output is agent/TUI compatible markdown; --json returns the same read-model as a stable envelope.
This skill is intentionally not a domain skill: presentation is a CLI-internal cockpit concern. Canonical view content lives in .aops-cache/docman/aops-guides/aops-cli-user-guide.md (AOPS markdown view sugar subsection); skill text is workflow + filter/selector reference.
When to use this skill
- Local-cache dashboards (project cockpit, board, sprint, task, issue, feedback, memory, resume, discussions)
- Hosted project inventory inspection (
hosted-projects,hosted-inventory) - Skill/prompt/doc mirror views from
.aops-cache/hosted/**/.aops-cache/docman/** - Focused context pack via
digest(sprint/task/board, depth shallow|deep) - Filter and selector contract for read-only views
Use another skill for
- CLI guard flags, sync, hosted mirror mechanics:
aops-cli-core. - Planning mutations (board/sprint/task/issue/feedback create/update):
aops-cli-projectman. - Memory/agent-profile mutations:
aops-cli-agentspace; discuss decision/consensus topics:aops-cli-discuss; chat coordination/wake:aops-cli-chat. - Document graph CRUD/search/publish:
aops-cli-docman. - File snapshot/copy/backup:
aops-cli-fileman. - Tasker / runner orchestration:
aops-cli-tasker.
Canonical sources (authoritative)
When this skill is silent, ambiguous, or out of date, defer to these:
.aops-cache/docman/aops-guides/aops-cli-user-guide.md— canonical CLI operator guide (includes the "AOPS markdown view sugar" section under ".aopslocal cache and sync").aops-cli view --helpand nested family help (per subcommand) — flag-level detail.- Section-focused reading on the CLI user guide via the doc discovery ladder:
There is no# broad search across the project's guides (local mirror, no id needed): aops-cli doc scope search --project-slug aops --q "view sugar" --local --json # exact search within a known guide version: aops-cli doc search --document-version-id <docver-id> --q "view sugar" --local --json # section tree of a known guide version (hosted-only — no local fallback): aops-cli doc outline get --document-version-id <docver-id> --jsonaops-cli docman … --slugcommand — use the ladder; reference sections by document title + section name + keywords, not bare numbers. - Local-cache views read
.aops/**/*.md; hosted views read hosted list APIs. Canonical truth still lives in the originating domain (Projectman, Agentspace, Docman, hosted server).
Discovery: which view for what
| Need | Command |
|---|---|
| Project cockpit | aops-cli view dashboard |
| Repo-bound projects | aops-cli view projects |
| Hosted Agentspace project list | aops-cli view hosted-projects |
| Per-project hosted inventory (docs/skills/prompts/resources) | aops-cli view hosted-inventory --hosted-project <slug> |
| Local-cache PM list views | aops-cli view boards/tasks/sprints/issues/feedback |
| Focused window detail | aops-cli view sprint|task|board <selector> |
| Agentspace context | aops-cli view memory/resume/experience/discussions |
| Hosted skill/prompt mirror | aops-cli view skills/prompts |
| Docman mirror | aops-cli view docs/doc/doc-page |
| Focused context pack (handoff) | aops-cli view digest --sprint|--task|--board <selector> --depth shallow|deep |
Selector contract (essential)
- Local-cache selectors accept full UUID, 8+ char prefix, slug, or exact title.
- Hosted project selectors accept hosted project id, scope id, slug, name, or 8+ char prefix via
--hosted-project. - Slug match is case-insensitive; exact title/name match is whitespace-trimmed.
- Ambiguous selectors raise an error listing candidates so the operator can disambiguate.
Filter matrix (essential)
| Komut | Filter flag'leri | Anlam |
|---|---|---|
view memory, view resume |
--durability, --kind, --subject, --id |
durability=short|durable|sticky; kind=kickoff|resume|closeout|note|rule|...; subject=project|board|sprint|task|ktask|utask|issue|feedback; id=full UUID veya 8+ char prefix |
view tasks |
--board, --status |
board=slug/name/id; status=column adı veya slug |
view issues, view feedback |
--status, --severity, --board, --sprint, --task |
status=frontmatter; severity=low|medium|high|critical |
view sprints |
--board, --status |
board=slug/name; status=todo|doing|completed|paused |
view discussions |
--status, --agent |
status=active|concluding|concluded|abandoned; agent=participants |
view experience |
--type, --area |
type=technique|tool|script|problem-solution|idea; area=tag |
view hosted-inventory |
--hosted-project, --scope-resolution |
hostedProject=id/slug/name/prefix; scopeResolution=explicit|cascade |
Filters AND together. Empty result emits No matching records. fallback.
Output controls
| Flag | Effect |
|---|---|
--style agent|compact|wide |
layout density |
--json |
scriptable envelope (surface: "local-cache-view" or "hosted-view") |
--max-items <n> |
cap returned/rendered records |
--max-bytes <n> |
hard-capped at 32768 |
--link-mode none|relative|absolute |
path link rendering; default is none |
Local-cache JSON envelope footer: local-state (synced/dirty/conflict/local/deleted), not raw syncState. Hosted JSON envelope: surface: "hosted-view".
Hosted commands also accept common auth flags: --api-base-url, --access-token, --refresh-token, --timeout-ms, --tenant-id, --locale, --fallback-locale, --scope-id, --scope-resolution. Local-cache command help may display these shared flags, but they are only used by explicit hosted view commands.
Common workflows
Workflow 1: Daily cockpit
aops-cli view dashboard --style agent
aops-cli view boards
aops-cli view tasks --board <slug> --status Doing
aops-cli view issues --status open --severity high
aops-cli view feedback --status openWorkflow 2: Focused subject inspection
aops-cli view sprint <selector> --max-items 20
aops-cli view task <selector>
aops-cli view memory --subject sprint --id <sprint-id>
aops-cli view resume --subject projectWorkflow 3: Handoff context pack
aops-cli view digest --sprint <sprint-id> --depth shallow
aops-cli view digest --task <task-id> --depth deep --max-bytes 32768
aops-cli view digest --board <board-slug> --depth deepWorkflow 4: Hosted inventory inspection (read-only)
aops-cli view hosted-projects --style compact
aops-cli view hosted-inventory --hosted-project <slug> --scope-resolution explicitAlways rules (pointers; do not duplicate the rule body here)
- View is read-only by contract — never mutates, syncs, or refreshes mirrors.
- Local-cache view commands read only
.aops/**/*.md; hosted view commands call only hosted read/list APIs. - View does NOT refresh
.aops-cache/hosted/**or.aops-cache/docman/**mirrors; useaops-cli sync pullfor hosted prompt/skill mirrors andaops-cli doc mirror pullfor Docman guide mirrors. - Use selectors before guessing UUIDs; if a selector is ambiguous, run a list view first to disambiguate.
- Filter flags AND together; empty result emits
No matching records.fallback (intentional, not an error). - Use focused
view digestover genericview dashboardwhen handing off context to another agent — digest scopes per subject and respects--depth.
Top anti-patterns
Most common failure modes:
- Using
viewas a mutation surface. View is read-only by contract. - Treating
view dashboardJSON as canonical state. It is a composed read-model; canonical state remains per-domain. - Treating
view hosted-inventoryas sync/bootstrap. It only reads; hosted prompt/skill mirror update issync pull, while Docman guide mirror update isdoc mirror pull. - Bypassing selector errors by guessing UUIDs. Run a list view first when ambiguous.
- Editing derived view files (
.aops-cache/projectman/views/index.md, etc) — they are regenerated after every mutation. - Loading
view dashboardfor handoff instead of focusedview digest --depth shallow|deep.
V2 deferred surfaces
Documented for awareness; not yet shipped:
view relations <selector>— cross-domain RelationResolver.view skill|prompt|experience <selector>detail inspect.aops-cli ls,aops-cli showaliases.--out <path>artifact writer (stdout remains default).- Hosted relation graph deeper edge resolver.
- Cache/index when performance demands.
Deep reading
For section-focused reading instead of full-file linear reads:
# broad search across the project's guides (local mirror, no id needed):
aops-cli doc scope search --project-slug aops --q "view sugar" --local --json
aops-cli doc scope search --project-slug aops --q "filter" --local --json
aops-cli doc scope search --project-slug aops --q "digest" --local --json
# exact search within a known guide version:
aops-cli doc search --document-version-id <docver-id> --q "view sugar" --local --json
# section tree of a known guide version (hosted-only — no local fallback):
aops-cli doc outline get --document-version-id <docver-id> --jsonThere is no aops-cli docman … --slug command — use the ladder; reference sections by document title + section name + keywords, not bare numbers.
For flag-level detail per command, always run --help first:
aops-cli view --help
aops-cli view dashboard --help
aops-cli view hosted-projects --help
aops-cli view hosted-inventory --help
aops-cli view sprint --help
aops-cli view task --help
aops-cli view board --help
aops-cli view digest --help
aops-cli view memory --help
aops-cli view discussions --helpIf --help and this skill disagree, --help wins (canonical command surface). If .aops-cache/docman/aops-guides/aops-cli-user-guide.md and this skill disagree, user guide wins.
