{"_id":"@at3ch/playbookws","name":"@at3ch/playbookws","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@at3ch/playbookws","version":"1.0.0","description":"Interactive CLI tool to browse and access Potentialis Day workshop prompts","license":"MIT","bin":{"playbookws":"dist/cli.js","playbookws-cli":"dist/cli.js"},"type":"module","engines":{"node":">=16"},"scripts":{"build":"tsc","dev":"tsc --watch","test":"prettier --check . && xo && ava","lint":"prettier --check . && xo","format":"prettier --write .","prepublishOnly":"npm run build"},"dependencies":{"cross-fetch":"^4.1.0","figlet":"^1.9.4","ink":"^6.5.1","ink-select-input":"^6.2.0","ink-spinner":"^5.0.0","ink-text-input":"^6.0.0","meow":"^11.0.0","open":"^11.0.0","qrcode":"^1.5.4","react":"^19.2.0"},"devDependencies":{"@sindresorhus/tsconfig":"3.0.1","@types/figlet":"^1.7.0","@types/qrcode":"^1.5.6","@types/react":"^18.0.32","@vdemedes/prettier-config":"^2.0.1","ava":"^5.2.0","chalk":"^5.6.2","eslint-config-xo-react":"^0.27.0","eslint-plugin-react":"^7.32.2","eslint-plugin-react-hooks":"^4.6.0","ink-testing-library":"^3.0.0","prettier":"^2.8.7","ts-node":"^10.9.1","tsimp":"^2.0.12","typescript":"^5.9.3","xo":"^1.2.3"},"ava":{"extensions":{"ts":"module"},"nodeArguments":["--import=tsimp"]},"prettier":"@vdemedes/prettier-config","_id":"@at3ch/playbookws@1.0.0","gitHead":"104fb9c77e7224f17d0e20667ec524194e0364e4","_nodeVersion":"22.17.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-rErSBqYFurdkouFYCTTy/f8tFGQeaxzLvN9WBbjzGCVMjSAQRkp6LdgD370eB4KFTJgPaco4sRhLgnaoNHgGBw==","shasum":"d14ecce8e54376a9f22b8f4f37c37b9d98ccb8fd","tarball":"https://registry.npmjs.org/@at3ch/playbookws/-/playbookws-1.0.0.tgz","fileCount":14,"unpackedSize":16915,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIDcKdUgaXbqGWZ7ZVqWFG+j4IqHqdba+7lcD5sVI3lauAiAFe3wNGxUHc3OT9/9S2phT+l7vaWr72hkKRbr7IldEaQ=="}]},"_npmUser":{"name":"at3ch","email":"accounts@aburady.com"},"directories":{},"maintainers":[{"name":"at3ch","email":"accounts@aburady.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/playbookws_1.0.0_1763943020873_0.6057619717686951"},"_hasShrinkwrap":false}},"time":{"created":"2025-11-24T00:10:20.762Z","1.0.0":"2025-11-24T00:10:21.057Z","modified":"2025-11-24T00:10:21.368Z"},"maintainers":[{"name":"at3ch","email":"accounts@aburady.com"}],"description":"Interactive CLI tool to browse and access Potentialis Day workshop prompts","license":"MIT","readme":"# Playbook Workshop TUI\n\nInteractive CLI tool to browse and access Potentialis Day workshop prompts.\n\n## Features\n\n- 🔍 **Browse all prompts** - View both listed and unlisted prompts\n- 🎯 **Search & filter** - Quickly find prompts by typing to search\n- ⌨️ **Keyboard navigation** - Navigate with arrow keys and Enter\n- 🔗 **Quick access** - Get direct URLs to prompt pages\n- 📱 **QR codes** - Generate QR codes in terminal for easy mobile access\n- 💾 **Download QR codes** - Save QR codes as PNG files to current directory\n- 🎨 **Beautiful UI** - Colorful terminal interface with visual indicators\n\n## Installation\n\nInstall globally from npm:\n\n```bash\nnpm install -g @potentialis/playbookws\n```\n\n### For Development\n\n1. Clone the repository:\n\n```bash\ngit clone git@github.com:YOUR_ORG/playbook-workshop-tui.git\ncd playbook-workshop-tui\n```\n\n2. Install dependencies:\n\n```bash\nbun install\n```\n\n3. Build the project:\n\n```bash\nbun run build\n```\n\n4. Link locally for testing:\n\n```bash\nnpm link\n```\n\n## Usage\n\nSimply run the command:\n\n```bash\nplaybookws\n```\n\n### Interactive Controls\n\n1. **Search**: Start typing to filter prompts in real-time\n2. **Navigate**: Use ↑ ↓ arrow keys to move through the list\n3. **Select**: Press Enter to view a prompt's details\n4. **Download**: Select \"Download QR Code\" to save QR code as PNG\n5. **Back**: Select \"Back to List\" or press Enter on \"Back to List\" to return\n\n### Example Workflow\n\n```bash\n$ playbookws\n\n🔍 Search: [type to filter]\n10 prompts found\n\n  Workflow Mapping Assistant\n  AI Critical Thinking Partner\n▶ Socrates AI Critical Thinking Partner\n  Consequence Predictor\n  ...\n```\n\nAfter selecting a prompt:\n\n```\nSocrates AI Critical Thinking Partner (Sharper Version)\nStatus: Listed\n\nURL: https://workshop.potentialis.ai/03-socrates-ai-critical-thinking-partner-sharper-version\n\n[QR CODE DISPLAYED IN TERMINAL]\n\nSelect an option:\n▶ 💾 Download QR Code\n  ← Back to List\n```\n\n## Configuration\n\nThe base URL is configured in `source/config.ts`. To change the API endpoint:\n\n```typescript\nexport const BASE_URL = 'https://workshop.potentialis.ai';\n```\n\nAfter changing, rebuild the project:\n\n```bash\nbun run build\n```\n\n## API Endpoint\n\nThe CLI connects to the `/api/prompts` endpoint which returns:\n\n```json\n[\n\t{\n\t\t\"slug\": \"prompt-slug\",\n\t\t\"title\": \"Prompt Title\",\n\t\t\"listed\": true,\n\t\t\"url\": \"https://workshop.potentialis.ai/prompt-slug\"\n\t}\n]\n```\n\n## Development\n\n### Scripts\n\n- `bun run build` - Compile TypeScript to JavaScript\n- `bun run dev` - Watch mode for development\n- `bun run test` - Run tests with formatting and linting\n\n### Project Structure\n\n```\nplaybook-workshop-tui/\n├── source/\n│   ├── cli.tsx              # CLI entry point\n│   ├── app.tsx              # Main application component\n│   ├── api.ts               # API client\n│   ├── config.ts            # Configuration (BASE_URL)\n│   └── components/\n│       ├── PromptList.tsx   # List view with search\n│       └── PromptDetail.tsx # Detail view with QR code\n├── dist/                    # Compiled JavaScript (gitignored)\n├── package.json\n└── tsconfig.json\n```\n\n## Dependencies\n\n- **ink** - Terminal UI framework\n- **ink-select-input** - Interactive list selection\n- **ink-text-input** - Search input component\n- **ink-spinner** - Loading spinner\n- **qrcode** - QR code generation (for PNG files)\n- **qrcode-terminal** - QR code display in terminal\n- **cross-fetch** - HTTP client\n- **meow** - CLI argument parser\n- **React** - UI library\n\n## Requirements\n\n- Node.js 16 or higher\n- Access to the API endpoint at `https://workshop.potentialis.ai`\n\n## Troubleshooting\n\n### Connection Error\n\nIf you see \"Unable to connect to API\", ensure:\n\n1. The Next.js app is deployed and accessible\n2. The `/api/prompts` endpoint is working\n3. You have internet connectivity\n\n### Build Errors\n\nIf build fails:\n\n```bash\nrm -rf node_modules dist\nbun install\nbun run build\n```\n\n## License\n\nMIT\n","readmeFilename":"readme.md","_rev":"1-14dedc78dbfa9e7f54af5d5dd3899df8"}