Skip to content
Back to search

dashbash

MarketplaceWorks with Claude CodeGitHub

DashBash: a live plan dashboard skill for Claude Code.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/niypoo--dashbash/badge.svg)](/listings/niypoo--dashbash)

HTML

<a href="/listings/niypoo--dashbash"><img src="/api/listings/niypoo--dashbash/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

In Claude Code:

/plugin install dashbash --marketplace niypoo/dashbash

On older Claude Code versions, add the marketplace first:

/plugin marketplace add niypoo/dashbash
/plugin install dashbash@dashbash

Or clone it as a personal skill:

git clone https://github.com/niypoo/dashbash ~/.claude/skills/dashbash

Start a new session (or run `/reload-plugins`) and it's ready. Python 3 is the only requirement (standard library only). Publishing the live dashboard uses claude.ai Artifacts; without them the page still works as a local HTML file.

Other coding agents (Codex, Gemini CLI, Cursor, Copilot, …)

DashBash's CLI and page don't depend on any model. Clone it anywhere, then teach your agent about it once per project:

git clone https://github.com/niypoo/dashbash ~/dashbash
cd your-project
python3 ~/dashbash/scripts/dashbash.py agents --for all --agent Codex

That adds a short DashBash section to the files agents read: `AGENTS.md` (Codex, Cursor, Jules, Amp and others), `GEMINI.md` (Gemini CLI), `.github/copilot-instructions.md` (Copilot) and `.cursor/rules/dashbash.mdc` (Cursor). Use `--for agents` (or `gemini`, `copilot`, `cursor`) to write just one. Running it again updates the section in place. `--agent` sets the name the page shows instead of "Claude".

Everything works the same - import, live updates, Progress, Mind map, Timeline, every export - except the claude.ai-only parts: the published link and comments sent straight to the model. On the local page, "Ask or comment" and the task buttons copy a ready message for you to paste into your agent's chat.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 16 lines
  1. {
  2. "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
  3. "name": "dashbash",
  4. "description": "DashBash: a live plan dashboard skill for Claude Code.",
  5. "owner": {
  6. "name": "niypoo"
  7. },
  8. "plugins": [
  9. {
  10. "name": "dashbash",
  11. "source": "./",
  12. "description": "A live dashboard of your plan that Claude keeps up to date while it works.",
  13. "version": "1.1.0"
  14. }
  15. ]
  16. }
README.md · README · 108 lines
  1. # DashBash
  2. **A live dashboard of your plan that Claude keeps up to date while it works.**
  3. Ask Claude "where are we?" once. DashBash builds a one-page dashboard of your plan, and from then on Claude updates it every time it finishes something. You always have one link that shows what is done, what Claude is doing now, and what is waiting on you.
  4. ![DashBash](assets/screenshot.jpg)
  5. ## Why DashBash
  6. - **Honest progress.** The percentage counts Claude's work only. Things that wait on you (a decision, a test on your phone, store details, a deploy) get their own card, so they never make the plan look stuck.
  7. - **Live, not a snapshot.** After every finished task Claude runs one command and republishes the same link. No servers, no extra tabs.
  8. - **Talk to it.** Every task has an "Ask or comment" button: send a question, a note or an alert straight to the Claude session working on the plan. Tasks that are yours have a check circle: mark one done or report a problem, and Claude updates the plan.
  9. - **Readable.** Every phase and task carries a one-line description of what it does, so titles never leave you guessing.
  10. - **Calm by default.** It opens on a short list of sections with one bar each. Click a section for its phases, a phase for its tasks. Two more views: a mind map of the whole plan and a timeline of what got done today, this week, this month or this quarter.
  11. - **Works with any plan.** Point it at a markdown checklist (`PLAN.md`, `TODO.md`, `ROADMAP.md`) and it reads phases, tasks and real completion dates from your git history. Or let Claude build it from the conversation.
  12. - **Any language.** English by default; Arabic and right-to-left layouts built in; any other language through a labels file.
  13. - **Take it with you.** Export a PDF report to send, an Excel workbook with progress bars and colored statuses, a markdown checklist you can import back, a CSV, or the full JSON.
  14. - **Yours to style.** Light or dark, accent color, eleven Arabic and Latin fonts, text size. Each viewer's choice stays in their browser.
  15. ## Install
  16. In Claude Code:
  17. ```
  18. /plugin install dashbash --marketplace niypoo/dashbash
  19. ```
  20. On older Claude Code versions, add the marketplace first:
  21. ```
  22. /plugin marketplace add niypoo/dashbash
  23. /plugin install dashbash@dashbash
  24. ```
  25. Or clone it as a personal skill:
  26. ```bash
  27. git clone https://github.com/niypoo/dashbash ~/.claude/skills/dashbash
  28. ```
  29. Start a new session (or run `/reload-plugins`) and it's ready. Python 3 is the only requirement (standard library only). Publishing the live dashboard uses claude.ai Artifacts; without them the page still works as a local HTML file.
  30. ### Other coding agents (Codex, Gemini CLI, Cursor, Copilot, …)
  31. DashBash's CLI and page don't depend on any model. Clone it anywhere, then teach your agent about it once per project:
  32. ```bash
  33. git clone https://github.com/niypoo/dashbash ~/dashbash
  34. cd your-project
  35. python3 ~/dashbash/scripts/dashbash.py agents --for all --agent Codex
  36. ```
  37. That adds a short DashBash section to the files agents read: `AGENTS.md` (Codex, Cursor, Jules, Amp and others), `GEMINI.md` (Gemini CLI), `.github/copilot-instructions.md` (Copilot) and `.cursor/rules/dashbash.mdc` (Cursor). Use `--for agents` (or `gemini`, `copilot`, `cursor`) to write just one. Running it again updates the section in place. `--agent` sets the name the page shows instead of "Claude".
  38. Everything works the same - import, live updates, Progress, Mind map, Timeline, every export - except the claude.ai-only parts: the published link and comments sent straight to the model. On the local page, "Ask or comment" and the task buttons copy a ready message for you to paste into your agent's chat.
  39. ## Use
  40. In any project, ask Claude:
  41. ```
  42. /dashbash
  43. ```
  44. or "where are we?", "what's left?", "what's waiting on me?". For another language, name it: `/dashbash ar`, "dashboard in Arabic".
  45. To stop live updates: "stop the dashboard".
  46. ### Your plan as a checklist
  47. DashBash reads plans like this (see [examples/PLAN.md](examples/PLAN.md)):
  48. ```markdown
  49. # My App
  50. ## Foundation
  51. ### Phase 0: Skeleton
  52. - [x] T1 Project scaffold
  53. - [ ] T2 CI pipeline
  54. ## Release
  55. ### Phase 1: Store
  56. - [ ] T3 Store listing
  57. - [ ] T4 Test on a real iPhone [you]
  58. ```
  59. `##` headings become sections, `###` headings phases, checkboxes tasks, and `[you]` marks a task as yours.
  60. ### The CLI
  61. Claude drives it, but you can too:
  62. ```bash
  63. PD="python3 ~/.claude/skills/dashbash/scripts/dashbash.py" # or the plugin's install folder
  64. $PD import PLAN.md # build or refresh from a markdown plan
  65. $PD set T2 done # mark done (stamps the date) and re-render
  66. $PD summary # 60% of Claude's tasks (3/5) · phases 1/3 · next: ...
  67. $PD validate # catch missing phases, duplicate ids, missing dates
  68. ```
  69. Everything lives in `.claude/status/` in your project: `status.json` (the data) and `dashboard.html` (the page). Add it to `.gitignore` if you don't want it committed.
  70. Full schema and commands: [reference.md](reference.md).
  71. ## License
  72. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.