# Ac List

> Check Auto-Claude kanban card status for any project without the GUI. Shows all specs with [OK] (complete), [--] (pending), [>>] (in-progress) status. Use when checking what specs are pending, complete, or running in any Auto-Claude project.

- Skill: `ryanmaclean/ac-list` (Agent Skill)
- Install (CLI): `npx skillmds@latest add ryanmaclean/ac-list`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ryanmaclean/ac-list/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: ryanmaclean (https://skillmd.com/u/ryanmaclean)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ryanmaclean/ac-list

---


# ac-list — Auto-Claude Headless Kanban Status

Shows all specs and their kanban state for a project without opening the GUI.

## Command

```bash
PYTHONPATH=/Applications/Auto-Claude.app/Contents/Resources/python-site-packages \
  env -u CLAUDECODE \
  /Applications/Auto-Claude.app/Contents/Resources/python/bin/python3 \
  /Applications/Auto-Claude.app/Contents/Resources/backend/run.py \
  --list --project-dir /path/to/project
```

## Status symbols

| Symbol | Meaning |
|--------|---------|
| `[OK]` | Complete — all subtasks done |
| `[--]` | Pending / initialized — not started |
| `[>>]` | In progress — currently running |
| `[XX]` | Failed |

## Filter examples

```bash
# Count pending specs
... --list --project-dir $HOME/efi | grep "\[--\]" | wc -l

# Show only complete
... --list --project-dir $HOME/efi | grep "\[OK\]"

# Show only pending
... --list --project-dir $HOME/efi | grep "\[--\]"

# Show in-progress
... --list --project-dir $HOME/efi | grep "\[>>\]"
```

## Projects

| Project | Path |
|---------|------|
| dub (EFI bootloader) | `$HOME/efi` |
| bop (jobcard system) | `$HOME/bop` |
| zam (unikernel VM reader) | `$HOME/zam` |

## Notes

- `env -u CLAUDECODE` is required — strips the Claude Code env var so run.py uses OAuth, not an API key
- This reads directly from `.auto-claude/specs/*/` on disk — no GUI, no network
- Complements `./dispatch.nu status` which tracks wave-level completion; this shows Auto-Claude's own subtask-level view
- `[OK]` in ac-list + entry in `dispatch-state.json` completed = fully done
- `[OK]` in ac-list but NOT in `dispatch-state.json` = completed but `mark-done` never fired → run `./dispatch.nu mark-done NNN`