{"_id":"@arenahito/piggychick","_rev":"3-a5905d40db9411de542b98cef4f55604","name":"@arenahito/piggychick","dist-tags":{"latest":"0.2.2"},"versions":{"0.1.0":{"name":"@arenahito/piggychick","version":"0.1.0","license":"MIT","_id":"@arenahito/piggychick@0.1.0","maintainers":[{"name":"arenahito","email":"mt@xfutures.jp"}],"homepage":"https://github.com/arenahito/piggychick#readme","bugs":{"url":"https://github.com/arenahito/piggychick/issues"},"bin":{"pgch":"bin/pgch.js"},"dist":{"shasum":"e1e249622eaddd8abb770fa07427e87b24c2aeb3","tarball":"https://registry.npmjs.org/@arenahito/piggychick/-/piggychick-0.1.0.tgz","fileCount":18,"integrity":"sha512-rERf1DTHrUiK8ZtFpDZKoMMAKNR5trqgjh1mRVKYMKdbhUDPuvmxOKy6rZkEge0TTc56RA09oKX6RItcBw2ikg==","signatures":[{"sig":"MEQCIFKA2reRYiJvLOHvmbW3FCvdd92V+Ou/XxC+XfHwD8x4AiAITRCQAkIdmO14+pYm9CKwuEjB5D2GZJOE9mMmINcQYg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":5897569},"type":"module","gitHead":"0c222d752718cd5621b784bad88e887f9c6d6553","scripts":{"dev":"concurrently \"bun --watch src/server/index.ts\" \"bun run dev:client\"","fmt":"oxfmt","lint":"oxlint . --ignore-path .oxlintignore","test":"bun test","build":"bun run build:client","start":"bun src/server/index.ts","prepare":"bun run build","fmt:check":"oxfmt --check","typecheck":"tsgo --project tsconfig.json","dev:client":"mkdir -p dist dist/assets && cp src/client/index.html dist/index.html && cp node_modules/github-markdown-css/github-markdown.css dist/markdown.css && bun build --watch src/client/main.ts --outdir dist/assets --target browser","build:client":"mkdir -p dist dist/assets && bun build src/client/main.ts --outdir dist/assets --target browser && cp src/client/index.html dist/index.html && cp node_modules/github-markdown-css/github-markdown.css dist/markdown.css"},"_npmUser":{"name":"arenahito","email":"mt@xfutures.jp"},"repository":{"url":"git+https://github.com/arenahito/piggychick.git","type":"git"},"_npmVersion":"11.9.0","description":"**A friendly viewer for AI-generated planning documents.**","directories":{},"_nodeVersion":"24.13.0","dependencies":{"open":"^11.0.0","mermaid":"^11.12.2","dompurify":"^3.3.1","markdown-it":"^14.1.0","d3-transition":"^3.0.1","github-markdown-css":"^5.8.1","markdown-it-task-lists":"^2.1.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"oxfmt":"^0.27.0","oxlint":"^1.42.0","cross-env":"^7.0.3","@types/bun":"^1.3.8","typescript":"^5.9.3","@types/node":"^25.1.0","concurrently":"^9.2.1","@types/markdown-it":"^14.1.2","@typescript/native-preview":"^7.0.0-dev.20260130.1"},"_npmOperationalInternal":{"tmp":"tmp/piggychick_0.1.0_1770792045187_0.34846641777759846","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@arenahito/piggychick","version":"0.2.1","license":"MIT","_id":"@arenahito/piggychick@0.2.1","maintainers":[{"name":"arenahito","email":"mt@xfutures.jp"}],"homepage":"https://github.com/arenahito/piggychick#readme","bugs":{"url":"https://github.com/arenahito/piggychick/issues"},"bin":{"pgch":"bin/pgch.js"},"dist":{"shasum":"1a7e623b0c1fdd344e6dc920eee5aad5f6f47e66","tarball":"https://registry.npmjs.org/@arenahito/piggychick/-/piggychick-0.2.1.tgz","fileCount":17,"integrity":"sha512-KfzHxKMWheYxU/uY5tG0STFSVUFpOUMo4z+rLvYbdUKMmtwHvKQIbRgdCAEzksNp/e1349iVst8mwXIxFRmVTw==","signatures":[{"sig":"MEUCIQDFymI8K4SwCzde85qOGeGaXyjMBgQQ5utQx1erJ2t1/AIgV4SXuXxVucWAOeTjvlQwUB9cut2Hm1hUW4dffnpGmdE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@arenahito%2fpiggychick@0.2.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":5929588},"type":"module","gitHead":"957c4daa6190e941a024d38c56fc94ab6cd905eb","scripts":{"dev":"concurrently \"bun --watch src/server/index.ts\" \"bun run dev:client\"","fmt":"oxfmt","lint":"oxlint . --ignore-path .oxlintignore","test":"bun test","build":"bun run build:client","start":"bun src/server/index.ts","prepare":"bun run build","fmt:check":"oxfmt --check","typecheck":"tsgo --project tsconfig.json","dev:client":"mkdir -p dist dist/assets && cp src/client/index.html dist/index.html && cp node_modules/github-markdown-css/github-markdown.css dist/markdown.css && bun build --watch src/client/main.ts --outdir dist/assets --target browser","build:client":"mkdir -p dist dist/assets && bun build src/client/main.ts --outdir dist/assets --target browser && cp src/client/index.html dist/index.html && cp node_modules/github-markdown-css/github-markdown.css dist/markdown.css"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:5ffa692c-0c53-4f90-9b0a-46e02929aeca"}},"repository":{"url":"git+https://github.com/arenahito/piggychick.git","type":"git"},"_npmVersion":"11.9.0","description":"**A friendly viewer for AI-generated planning documents.**","directories":{},"_nodeVersion":"24.13.0","dependencies":{"open":"^11.0.0","mermaid":"^11.12.2","dompurify":"^3.3.1","markdown-it":"^14.1.0","d3-transition":"^3.0.1","github-markdown-css":"^5.8.1","markdown-it-task-lists":"^2.1.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"oxfmt":"^0.27.0","oxlint":"^1.42.0","cross-env":"^7.0.3","@types/bun":"^1.3.8","typescript":"^5.9.3","@types/node":"^25.1.0","concurrently":"^9.2.1","@types/markdown-it":"^14.1.2","@typescript/native-preview":"^7.0.0-dev.20260130.1"},"_npmOperationalInternal":{"tmp":"tmp/piggychick_0.2.1_1770793907908_0.9136447025642134","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"@arenahito/piggychick","version":"0.2.2","license":"MIT","repository":{"type":"git","url":"git+https://github.com/arenahito/piggychick.git"},"bin":{"pgch":"bin/pgch.js"},"type":"module","publishConfig":{"access":"public"},"scripts":{"dev":"concurrently \"bun --watch src/server/index.ts\" \"bun run dev:client\"","dev:client":"mkdir -p dist dist/assets && cp src/client/index.html dist/index.html && cp node_modules/github-markdown-css/github-markdown.css dist/markdown.css && bun build --watch src/client/main.ts --outdir dist/assets --target browser","start":"bun src/server/index.ts","build":"bun run build:client","build:client":"mkdir -p dist dist/assets && bun build src/client/main.ts --outdir dist/assets --target browser && cp src/client/index.html dist/index.html && cp node_modules/github-markdown-css/github-markdown.css dist/markdown.css","fmt":"oxfmt","fmt:check":"oxfmt --check","lint":"oxlint . --ignore-path .oxlintignore","typecheck":"tsgo --project tsconfig.json","test":"bun test","prepare":"bun run build"},"dependencies":{"d3-transition":"^3.0.1","dompurify":"^3.3.1","github-markdown-css":"^5.8.1","markdown-it":"^14.1.0","markdown-it-task-lists":"^2.1.1","mermaid":"^11.12.2","open":"^11.0.0"},"devDependencies":{"@types/bun":"^1.3.8","@types/markdown-it":"^14.1.2","@types/node":"^25.1.0","@typescript/native-preview":"^7.0.0-dev.20260130.1","concurrently":"^9.2.1","cross-env":"^7.0.3","oxfmt":"^0.27.0","oxlint":"^1.42.0","typescript":"^5.9.3"},"gitHead":"99662e8189235d4109c96bb014d7473fb160ac99","_id":"@arenahito/piggychick@0.2.2","description":"**A friendly viewer for AI-generated planning documents.**","bugs":{"url":"https://github.com/arenahito/piggychick/issues"},"homepage":"https://github.com/arenahito/piggychick#readme","_nodeVersion":"24.13.0","_npmVersion":"11.10.0","dist":{"integrity":"sha512-WMBz1Gtxi/U1meVw2v2fFXierdM5J31I1XnlMIJTtH0XeKSzR3RdE//mv2/9eMxUXFnfuCpyv3ZHl0zDx4NcYw==","shasum":"415c5ae3024b96db035e5f78dcd7edec9c1384d8","tarball":"https://registry.npmjs.org/@arenahito/piggychick/-/piggychick-0.2.2.tgz","fileCount":17,"unpackedSize":5933811,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@arenahito%2fpiggychick@0.2.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCIbRt7IjVKdyqGuBECeq4qsns5HQGUyG8/DShBgr/8nQIgQ6USyQf61E9b1Npnes0Ms64VzcyLnXmvEyQC3FU+qgs="}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:5ffa692c-0c53-4f90-9b0a-46e02929aeca"}},"directories":{},"maintainers":[{"name":"arenahito","email":"mt@xfutures.jp"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/piggychick_0.2.2_1771117412120_0.0997140267909642"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-11T06:40:45.038Z","modified":"2026-02-15T01:03:32.754Z","0.1.0":"2026-02-11T06:40:45.364Z","0.2.1":"2026-02-11T07:11:48.174Z","0.2.2":"2026-02-15T01:03:32.485Z"},"bugs":{"url":"https://github.com/arenahito/piggychick/issues"},"license":"MIT","homepage":"https://github.com/arenahito/piggychick#readme","repository":{"type":"git","url":"git+https://github.com/arenahito/piggychick.git"},"description":"**A friendly viewer for AI-generated planning documents.**","maintainers":[{"name":"arenahito","email":"mt@xfutures.jp"}],"readme":"# PiggyChick\n\n**A friendly viewer for AI-generated planning documents.**\n\n![PiggyChick](docs/piggychick.jpg)\n\n## What is this?\n\nWhen coding with AI agents (such as Claude Code, Codex CLI, or OpenCode),\nthere are \"skills\" that help you follow a plan-then-implement workflow.\n\nThese skills automatically generate planning documents (PRDs) in a `.tasks`\ndirectory. **PiggyChick displays these documents in a clean, browsable web UI.**\n\n- Beautiful Markdown rendering\n- Visual dependency graphs for tasks\n- Multi-project support\n\n## Installation\n\nRequires:\n\n- [Node.js](https://nodejs.org/)\n- [Bun](https://bun.sh/)\n\n```bash\n# Try it instantly (no install needed)\nnpx github:arenahito/piggychick\n\n# Install globally (recommended)\nnpm install -g github:arenahito/piggychick\npgch\n```\n\n## Usage\n\n### Register a project\n\nAdd projects you want to view in PiggyChick:\n\n```bash\n# Register current directory\npgch add\n\n# Register a specific path\npgch add ./path/to/project\n```\n\n### Start the viewer\n\n```bash\npgch\n```\n\nOpen `http://localhost:42525` in your browser to view registered projects and\ntheir planning documents.\n\n### Other commands\n\n```bash\npgch list     # List registered projects\npgch remove   # Unregister current directory\npgch config   # Show config file location\n```\n\n## Compatible Skills\n\nPiggyChick works with `.tasks` directories created by these skills:\n\n- **impl-plan**: Creates planning documents\n- **impl-do**: Implements tasks from planning documents\n\nSkills are located in `skills/impl/`. They work with AI agents that support\ncustom skills, including Claude Code, Codex CLI, OpenCode, and others.\n\n## UI Overview\n\n![Screenshot](docs/screen.png)\n\n| Element | Description |\n|---------|-------------|\n| Sidebar | Project and PRD list with progress indicators |\n| Main panel | Rendered plan markdown and task dependency graph views |\n\nChanges under `.tasks` are picked up automatically in the UI while the viewer is open.\n\n### Dependency Graph Controls\n\n- `+` / `-` buttons: Zoom in and out\n- `100%` button: Reset zoom to default\n- `Ctrl/Meta + mouse wheel`: Zoom at pointer position\n- Drag inside the graph viewport: Pan to hidden graph areas\n\n---\n\n## For Developers\n\n### Required Files\n\nEach PRD directory must contain:\n\n- `plan.md` - The planning document\n- `plan.json` - Task definitions and dependencies\n  - Preferred progress field: `tasks[].status` (`pending`, `in_progress`, `done`)\n  - Backward compatibility: `tasks[].passes` is still supported when `status` is absent\n  - Precedence rule: when both `status` and `passes` exist, `status` is used\n\nAdditional `.md` files are shown as extra documents when present.\n\n### Config File\n\nLocation: `~/.config/piggychick/config.jsonc`\n\n```jsonc\n{\n  // PiggyChick config\n  \"tasksDir\": \".tasks\",\n  \"roots\": [\n    { \"path\": \"/path/to/project\" },\n    { \"path\": \"/path/to/other-project\", \"tasksDir\": \".tasks-prd\" }\n  ]\n}\n```\n\n- `tasksDir`: Task directory name (default: `.tasks`)\n- `roots`: List of projects to monitor. Each project can override `tasksDir`\n\n### Release Automation\n\n- Use [Conventional Commits](https://www.conventionalcommits.org/) for changes that should appear in release notes.\n- `release-please` runs on pushes to `main` and opens/updates a release PR.\n- Merging the release PR triggers automated lint, typecheck, test, build, and npm publish.\n- npm publishing uses Trusted Publishing (OIDC). Configure npm Trusted Publisher for `.github/workflows/release-please.yml`.\n\n### Development Setup\n\n```bash\nbun install   # Install dependencies\nbun run dev   # Start dev server (http://localhost:3000)\n```\n\n### Other Commands\n\n```bash\nbun run build      # Production build\nbun run lint       # Run linter\nbun run fmt        # Format code\nbun run typecheck  # Type check\nbun test           # Run tests\n```\n","readmeFilename":"README.md"}