hammoc 1.0.0 → 1.0.3

package/README.md

@@ -1,9 +1,16 @@
 <p align="center">
-  <h1 align="center">HAMMOC</h1>
-  <p align="center"><strong>Command. Kick Back. Ship.</strong></p>
-  <p align="center">
-    An agentic IDE that lets AI handle the heavy lifting — while you stay in control.
-  </p>
+  <img src="logo/Hammoc-Header.png" alt="Hammoc" width="480">
+</p>
+
+<p align="center">
+  <strong>Kick Back. Tap. Ship.</strong><br>
+  The web IDE built for AI-driven development workflows — starting with BMAD-METHOD.
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/hammoc"><img src="https://img.shields.io/npm/v/hammoc" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/hammoc"><img src="https://img.shields.io/npm/dm/hammoc" alt="npm downloads"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/github/license/starsh2001/hammoc" alt="license"></a>
 </p>
 
 <p align="center">
@@ -16,9 +23,11 @@
 
 ## What is Hammoc?
 
-Hammoc turns [Claude Code](https://docs.anthropic.com/en/docs/claude-code) into a full-featured development environment — accessible from any browser, any device.
+Hammoc is a web IDE optimized for structured AI-driven development methodologies. It currently provides first-class support for the [BMAD-METHOD V4](https://github.com/bmad-code-org/BMAD-METHOD) workflow — with plans to support additional methodologies in the future.
+
+Built on top of [Claude Code](https://docs.anthropic.com/en/docs/claude-code), Hammoc provides everything you need to run a full BMAD workflow from your browser: agent switching, PRD-to-queue automation, epic/story tracking, and a Kanban board — all in one place. No terminal hopping, no context switching.
 
-Like a hammock — you kick back and relax while the AI does the heavy lifting.
+Fully responsive and mobile-first. Kick back in your hammock, tap a command on your phone, and let the AI ship it. Inspired by Rich Hickey's *Hammock Driven Development* — the idea that real breakthroughs come when you step back, not when you're grinding at the terminal.
 
 ---
 
@@ -59,10 +68,31 @@ Options:
 
 Fully responsive. Access from your phone or tablet at `http://<your-ip>:3000` on the same network.
 
+### PWA (Progressive Web App)
+
+Hammoc can be installed as a standalone app on your PC or mobile device.
+
+- **PC (localhost):** Open `http://localhost:3000` in Chrome → click the install icon in the address bar. No extra setup needed.
+- **Mobile (local network):** Requires HTTPS. See the [HTTPS Setup](#https-setup-for-mobile-pwa) section below.
+
+> ⚠️ **Security Notice**
+>
+> Hammoc has not undergone a formal security audit. Always run it on a **trusted local network** or behind a **trusted VPN** (e.g., Tailscale, WireGuard). Do **not** expose Hammoc to the public internet.
+
 ---
 
 ## Features
 
+### Why Hammoc?
+
+| | Hammoc | Terminal-based IDE | Generic Web IDE |
+|---|:---:|:---:|:---:|
+| BMAD-METHOD workflow | **Built-in** | Manual | N/A |
+| Agent switching (SM, PM, Dev, QA...) | **One tap** | CLI commands | N/A |
+| PRD → Queue automation | **Auto-generate** | Copy-paste | N/A |
+| Mobile development | **Full support** | Limited | Partial |
+| Kanban + Epic tracking | **Integrated** | Separate tool | Separate tool |
+
 ### Chat Interface
 
 Real-time conversations with Claude through a rich web UI.
@@ -162,16 +192,19 @@ Automate repetitive prompt sequences.
 
 ---
 
-## BMAD-METHOD Integration
+## BMAD-METHOD V4 Integration
 
-Hammoc provides first-class support for the [BMAD-METHOD](https://github.com/bmad-code-org/BMAD-METHOD) (Breakthrough Method for Agile AI-Driven Development) workflow.
+Hammoc is the most convenient way to run a full [BMAD-METHOD](https://github.com/bmad-code-org/BMAD-METHOD) (Breakthrough Method for Agile AI-Driven Development) workflow. Every step — from project inception to QA — is built into the IDE.
 
 - **One-click BMad setup** — Initialize `.bmad-core` in any project with version selection
-- **BMad Agent button** — Quick-switch between agents (SM, PM, Dev, QA, etc.) in chat
-- **Project overview** — Visual dashboard showing PRD completion, epic progress, and story status
-- **Queue templates from PRD** — Auto-generate prompt queues from your epics and stories
-- **Board integration** — Track epics and stories on the Kanban board with promote/validate workflows
-- **Story workflows** — Start development, request QA, and apply fixes through the board UI
+- **BMad Agent switching** — Instantly switch between agents (SM, PM, Architect, Dev, QA, PO, etc.) in chat with a single tap
+- **Slash commands per agent** — Context-aware `/commands` that change based on the active BMad agent
+- **PRD → Queue automation** — Auto-generate prompt queues directly from your PRD epics and stories
+- **Project overview dashboard** — Visual status showing PRD completion, epic progress, and story status
+- **Kanban board integration** — Track epics and stories with drag-and-drop, promote/validate workflows
+- **Story workflows** — Start development, request QA, and apply fixes — all through the board UI
+
+> **Methodology support roadmap:** Hammoc is designed to be methodology-agnostic. BMAD-METHOD V4 is the first supported workflow, with more development methodologies planned for future releases.
 
 For detailed BMAD-METHOD documentation, visit the [official repository](https://github.com/bmad-code-org/BMAD-METHOD).
 
@@ -240,10 +273,67 @@ npm run dev
 | App config & password | `~/.hammoc/config.json` |
 | User preferences | `~/.hammoc/preferences.json` |
 | Queue templates | `~/.hammoc/queue-templates.json` |
+| TLS certificates | `~/.hammoc/cert.pem`, `~/.hammoc/key.pem` |
 | Session data | `~/.claude/projects/` (managed by Claude Code CLI) |
 
 ---
 
+## HTTPS Setup (for Mobile PWA)
+
+PWA installation on mobile devices requires HTTPS. Hammoc automatically starts in HTTPS mode when TLS certificates are found at `~/.hammoc/cert.pem` and `~/.hammoc/key.pem`. If no certificates are found, it falls back to HTTP.
+
+### Option 1: mkcert (Recommended)
+
+1. **Install mkcert:**
+
+   ```bash
+   # Windows
+   winget install FiloSottile.mkcert
+
+   # macOS
+   brew install mkcert
+
+   # Linux
+   # See https://github.com/FiloSottile/mkcert#installation
+   ```
+
+2. **Create a local CA and generate certificates:**
+
+   ```bash
+   mkcert -install
+   mkcert -key-file ~/.hammoc/key.pem -cert-file ~/.hammoc/cert.pem localhost 127.0.0.1 YOUR_LOCAL_IP
+   ```
+
+   Replace `YOUR_LOCAL_IP` with your PC's IP address (e.g., `192.168.0.10`).
+
+3. **Install the root CA on your mobile device:**
+
+   Find the CA certificate location:
+   ```bash
+   mkcert -CAROOT
+   ```
+
+   Transfer `rootCA.pem` to your mobile device, then:
+   - **Android:** Settings → Security → Install certificate
+   - **iOS:** Open the file → Install Profile → Settings → General → About → Certificate Trust Settings → Enable
+
+4. **Start Hammoc** — it will automatically detect the certificates and start in HTTPS mode:
+
+   ```
+   Hammoc Server running on:
+     Local:   https://localhost:3000
+     Network: https://192.168.0.10:3000
+     TLS:     enabled (certs from ~/.hammoc/)
+   ```
+
+5. **Open on mobile:** Navigate to `https://YOUR_LOCAL_IP:3000` and install the PWA.
+
+### Option 2: Reverse Proxy
+
+If you already have a reverse proxy (Nginx, Caddy, etc.) handling HTTPS, simply keep Hammoc running in HTTP mode (no certificates needed) and point your proxy to `http://localhost:3000`.
+
+---
+
 ## Environment Variables
 
 | Variable | Default | Description |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hammoc",
-  "version": "1.0.0",
+  "version": "1.0.3",
   "description": "Web-based IDE for managing Claude Code sessions, projects, and workflows",
   "type": "module",
   "license": "AGPL-3.0-only",