hotsheet 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Brian Westphal
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,229 @@
+<div align="center">
+
+# Hot Sheet
+
+### A fast, local ticket tracker that feeds your AI coding tools.
+
+<br>
+
+**Hot Sheet** is a lightweight project management tool that runs entirely on your machine. Create tickets with a bullet-list interface, drag them into priority order, and your AI tools automatically get a structured worklist they can act on.
+
+No cloud. No logins. No JIRA. Just tickets and a tight feedback loop.
+
+<br>
+
+```bash
+npm install -g hotsheet
+```
+
+```bash
+hotsheet
+```
+
+That's it. Opens in your browser. Data stays local.
+
+</div>
+
+<br>
+
+<p align="center">
+  <img src="docs/demo-1.png" alt="Hot Sheet main UI showing tickets across categories, priorities, and statuses with the detail panel open" width="900">
+</p>
+
+---
+
+## Why Hot Sheet?
+
+AI coding tools are powerful, but they need direction. You know what needs to be built, fixed, or investigated — but communicating that to your AI tool means typing the same context over and over, or maintaining a text file that drifts out of sync.
+
+Hot Sheet gives you a proper ticket interface — categories, priorities, statuses — with one key difference: it automatically exports a `worklist.md` file that AI tools like Claude Code can read directly. Your tickets become the AI's task list.
+
+The workflow:
+
+1. **You** create and prioritize tickets in Hot Sheet
+2. **Hot Sheet** syncs an `Up Next` worklist to `.hotsheet/worklist.md`
+3. **Your AI tool** reads the worklist and works through it
+4. **You** mark tickets complete and add new ones
+
+The loop stays tight because the AI always knows what to work on next.
+
+---
+
+## Features
+
+**Bullet-list input** — type a title, hit Enter, ticket created. Set category and priority inline with keyboard shortcuts.
+
+<p align="center">
+  <img src="docs/demo-2.png" alt="Quick ticket entry with the bullet-list input row" width="900">
+</p>
+
+**Six ticket categories** — Issue, Bug, Feature, Requirement Change, Task, Investigation — each with a distinct color. **Sidebar filtering** lets you drill down by view, category, or priority.
+
+<p align="center">
+  <img src="docs/demo-3.png" alt="Sidebar filtering by Bug category" width="900">
+</p>
+
+**Batch operations** — select multiple tickets to bulk-update category, priority, status, or Up Next.
+
+<p align="center">
+  <img src="docs/demo-5.png" alt="Multiple tickets selected with the batch toolbar visible" width="900">
+</p>
+
+**Detail panel** — side or bottom orientation, resizable, with fields for title, details, attachments, and timestamped notes. Auto-shows when you select a ticket.
+
+<p align="center">
+  <img src="docs/demo-6.png" alt="Detail panel in bottom orientation showing ticket details and notes" width="900">
+</p>
+
+**Also includes:**
+- **Five priority levels** — Highest to Lowest, sortable and filterable
+- **Up Next flag** — star tickets to add them to the AI worklist
+- **Search** — full-text search across ticket titles and details
+- **Keyboard-driven** — `Enter` to create, `Cmd+I/B/F/R/K/G` for categories, `Alt+1-5` for priority, `Cmd+D` for Up Next
+- **File attachments** — attach files to any ticket
+- **Markdown sync** — `worklist.md` and `open-tickets.md` auto-generated on every change
+- **Auto-cleanup** — configurable auto-deletion of old trash and verified items
+- **Settings** — detail panel position, cleanup intervals, all persisted
+- **Fully local** — embedded PostgreSQL (PGLite), no network calls, no accounts, no telemetry
+
+---
+
+## AI Integration
+
+The exported worklist is plain markdown. Any AI tool that can read files can use it.
+
+Star tickets as "Up Next" and they appear in the worklist, sorted by priority. As the AI works, it updates ticket status and appends notes — visible right in the detail panel.
+
+<p align="center">
+  <img src="docs/demo-4.png" alt="Up Next view showing prioritized tickets with AI progress notes in the detail panel" width="900">
+</p>
+
+### Claude Code
+
+Point Claude Code at your worklist:
+
+```
+Read .hotsheet/worklist.md and work through the tickets in order.
+```
+
+Or add it to your `CLAUDE.md`:
+
+```markdown
+Read .hotsheet/worklist.md for current work items.
+```
+
+### Other AI Tools
+
+The worklist works with any AI tool that reads files — Cursor, Copilot, Aider, etc. Each ticket includes its number, type, priority, status, title, and details.
+
+### What gets exported
+
+`worklist.md` contains all tickets flagged as "Up Next," sorted by priority:
+
+```
+# Hot Sheet - Up Next
+
+These are the current priority work items. Complete them in order of priority, where reasonable.
+
+---
+
+TICKET HS-12:
+- Type: bug
+- Priority: highest
+- Status: not started
+- Title: Fix login redirect loop
+- Details: After session timeout, the redirect goes to /login?next=/login...
+
+---
+
+TICKET HS-15:
+- Type: feature
+- Priority: high
+- Status: started
+- Title: Add CSV export for reports
+```
+
+---
+
+## Install
+
+```bash
+npm install -g hotsheet
+```
+
+Requires **Node.js 20+**.
+
+---
+
+## Usage
+
+```bash
+# Start with defaults (port 4174, data in .hotsheet/)
+hotsheet
+
+# Custom port
+hotsheet --port 8080
+
+# Custom data directory
+hotsheet --data-dir ~/projects/my-app/.hotsheet
+```
+
+### Options
+
+| Flag | Description |
+|------|-------------|
+| `--port <number>` | Port to run on (default: 4174) |
+| `--data-dir <path>` | Data directory (default: `.hotsheet/`) |
+| `--help` | Show help |
+
+### Keyboard shortcuts
+
+| Shortcut | Action |
+|----------|--------|
+| `Enter` | Create new ticket |
+| `Cmd+I` | Set category: Issue |
+| `Cmd+B` | Set category: Bug |
+| `Cmd+F` | Set category: Feature |
+| `Cmd+R` | Set category: Req Change |
+| `Cmd+K` | Set category: Task |
+| `Cmd+G` | Set category: Investigation |
+| `Alt+1-5` | Set priority (Highest to Lowest) |
+| `Cmd+D` | Toggle Up Next |
+| `Cmd+A` | Select all |
+| `Escape` | Clear selection / close |
+
+---
+
+## Architecture
+
+| Layer | Technology |
+|-------|-----------|
+| CLI | TypeScript, Node.js |
+| Server | Hono |
+| Database | PGLite (embedded PostgreSQL) |
+| UI | Custom server-side JSX (no React), vanilla client JS |
+| Build | tsup (single-file bundle) |
+| Storage | `.hotsheet/` in your project directory |
+
+Data stays local. No network calls, no accounts, no telemetry.
+
+---
+
+## Development
+
+```bash
+git clone <repo-url>
+cd hotsheet
+npm install
+
+npm run dev              # Build client assets, then run via tsx
+npm run build            # Build to dist/cli.js
+npm run clean            # Remove dist and caches
+npm link                 # Symlink for global 'hotsheet' command
+```
+
+---
+
+## License
+
+MIT