@aladac/hu 0.1.0-a2 → 0.1.0-a3

package/CLAUDE.md

@@ -2,6 +2,16 @@
 
 This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
 
+## Important Guidelines
+
+**Before implementing new features**: Always check if Claude Code already has a built-in feature for the requested functionality:
+1. Check CLI help: `claude --help`
+2. Check interactive commands: `/help` within a session
+3. Search the web for "Claude Code [feature name]" to find recent additions
+4. Check official docs at docs.anthropic.com
+
+Don't duplicate existing capabilities.
+
 ## Overview
 
 This is the `~/.claude` configuration directory containing custom slash commands, CLI tools, and documentation management workflows for Claude Code.
@@ -11,6 +21,7 @@ This is the `~/.claude` configuration directory containing custom slash commands
 - `commands/` - Slash command definitions (`.md` files that become `/command-name`)
   - `docs/` - Documentation management commands (`/docs:*`)
   - `plans/` - Planning commands (`/plans:*`)
+  - `claude/` - Claude Code reference commands (`/claude:*`)
 - `src/` - TypeScript source for the `hu` CLI
   - `commands/` - CLI subcommand implementations
   - `lib/` - Shared utilities (fs, colors, html conversion, db, sync)
@@ -44,6 +55,7 @@ hu data todos pending          # Show pending todos
 hu data search <query>         # Search messages
 hu data tools                  # Show tool usage statistics
 hu data errors                 # Extract errors from debug logs
+hu data pricing                # Show pricing analysis
 ```
 
 ### hu docs
@@ -73,6 +85,13 @@ hu utils fetch-html <url> -c           # With extra cleaning
 hu utils fetch-html <url> -s "article" # Target CSS selector
 hu utils fetch-html <url> -o out.md    # Write to file
 
+hu utils plist <file>                  # Read plist as colorized JSON
+hu utils plist com.apple.finder        # Read app preferences by bundle ID
+hu utils plist -l                      # List available preference plists
+hu utils plist -s <pattern>            # Search for plists by name
+hu utils plist <file> -k <key>         # Extract specific key (dot notation)
+hu utils plist <file> -r               # Output raw JSON without colors
+
 hu utils sync-checkboxes               # Clean TODO.md/PLAN.md
 hu utils sync-checkboxes file.md       # Specific file
 hu utils sync-checkboxes -d            # Dry run
@@ -81,7 +100,68 @@ hu utils sync-checkboxes -d            # Dry run
 ### hu disk
 Disk space analysis (macOS):
 ```bash
-hu disk                        # Show disk usage summary
+hu disk                        # Full disk inventory
+hu disk overview               # APFS volume usage
+hu disk home                   # Home directory breakdown
+hu disk library                # ~/Library breakdown
+hu disk hogs                   # Check common space hogs
+hu disk models                 # List AI models
+hu disk cleanup                # Cleanup suggestions
+
+hu disk known                  # Scan all known space hogs with cleanup commands
+hu disk known dev-tools        # Filter by category (ai-models, dev-tools, apps, caches, system, media)
+hu disk known -m 1G            # Only show items >= 1GB
+hu disk known -j               # JSON output
+hu disk list-known             # List all known hog definitions
+hu disk list-known ai-models   # List definitions for category
+```
+
+### hu services
+Services and startup items management (macOS):
+```bash
+hu services summary            # Overview of all services
+hu services brew list          # List Homebrew services (-r for running only)
+hu services brew start <name>  # Start a brew service
+hu services brew stop <name>   # Stop a brew service
+hu services brew restart <name> # Restart a brew service
+hu services login              # List login items and user launch agents
+hu services launch list        # List launch agents/daemons (-t agent/daemon, -s user/system)
+hu services launch load <name> # Load (enable) a launch agent
+hu services launch unload <name> # Unload (disable) a launch agent
+```
+
+### hu gh
+GitHub integration:
+```bash
+hu gh config                   # Show GitHub configuration
+hu gh prs                      # List pull requests
+hu gh prs -s "search term"     # Search PRs
+hu gh runs                     # List workflow runs
+hu gh open <pr-number>         # Open PR in browser
+```
+
+### hu jira
+Jira integration:
+```bash
+hu jira auth                   # Authenticate with Jira via OAuth 2.0
+hu jira config                 # Show Jira configuration
+hu jira sprint                 # Show current sprint info
+hu jira tickets                # List assigned tickets (current sprint)
+hu jira search <query>         # Search tickets
+hu jira show <ticket>          # Show ticket details
+hu jira branch <ticket>        # Create git branch from ticket
+hu jira open <ticket>          # Open ticket in browser
+hu jira check                  # Find sprint tickets without descriptions
+```
+
+### hu settings
+Claude Code settings management:
+```bash
+hu settings show               # Show settings from all scopes
+hu settings edit               # Edit settings file in $EDITOR
+hu settings managed            # View/edit managed settings (highest priority)
+hu settings allow <pattern>    # Add a permission rule
+hu settings path               # Show paths to settings files
 ```
 
 ### hu plugin
@@ -91,6 +171,26 @@ hu plugin init <name>          # Initialize a new plugin
 hu plugin install              # Install plugin hooks
 ```
 
+### hu bump
+Version bumping with configurable patterns (auto-detects format from git tags):
+```bash
+hu bump run                    # Bump prerelease (0.1.0-a1 -> 0.1.0-a2)
+hu bump run patch              # Bump patch (0.1.0-a2 -> 0.1.1-a1)
+hu bump run minor              # Bump minor (0.1.0-a2 -> 0.2.0-a1)
+hu bump run major              # Bump major (0.1.0-a2 -> 1.0.0-a1)
+hu bump run -p pre             # Use -preN pattern instead of -aN
+hu bump run -p beta            # Use -betaN pattern
+hu bump run -p rc              # Use -rcN pattern
+hu bump run -p none            # No prerelease suffix (0.1.0)
+hu bump run -t ""              # No tag prefix (default: "v")
+hu bump run --no-tag           # Skip git tagging
+hu bump run --no-push          # Skip git push
+hu bump run -d                 # Dry run
+
+hu bump detect                 # Show detected version format
+hu bump detect -j              # JSON output
+```
+
 ## Slash Commands
 
 ### Documentation Management (`/docs:*`)
@@ -109,14 +209,19 @@ hu plugin install              # Install plugin hooks
 - `/plans:sync` - Sync TODO.md and PLAN.md progress
 - `/plans:clear` - Delete all saved plans
 
+### Claude Code Reference (`/claude:*`)
+- `/claude:reference [topic]` - Load Claude Code CLI reference documentation
+
 ### Utilities
 - `/c` - Quick commit: adds all files, commits with timestamp message
+- `/bump [type]` - Bump package version (prerelease/patch/minor/major)
+- `/publish` - Publish package to npm registry
 - `/disk` - Disk space analysis commands for macOS
+- `/pricing` - Show pricing analysis and competitor comparison
 - `/bootstrap` - Bootstrap hu if not installed
 - `/reinstall` - Reinstall hu from source
 - `/check-name <name>` - Check package name availability across registries
 - `/replicate` - Diagnose a reported issue and identify code areas to investigate
-- `/warp` - Custom command
 
 ## System Documents (Off-Limits)
 

package/commands/bump.md

@@ -0,0 +1,30 @@
+Bump package version. Auto-detects format from git tags.
+
+## Arguments
+
+$ARGUMENTS - bump type: `prerelease` (default), `patch`, `minor`, `major`
+
+## Usage
+
+```bash
+hu bump run $ARGUMENTS
+```
+
+## Options
+
+- `-p/--pattern` - prerelease pattern: `alpha` (a1), `pre` (pre1), `beta` (beta1), `rc` (rc1), `none`
+- `-t/--tag-prefix` - git tag prefix (default: "v", use "" for none)
+- `--no-tag` - skip git tagging
+- `--no-push` - skip git push
+- `--no-install` - skip npm install && npm link
+- `-d/--dry-run` - preview changes without executing
+
+## Examples
+
+- `/bump` - bump prerelease (0.1.0-a1 -> 0.1.0-a2)
+- `/bump patch` - bump patch (0.1.0-a2 -> 0.1.1-a1)
+- `/bump minor` - bump minor version
+- `/bump major` - bump major version
+- `/bump -d` - dry run to preview
+
+Run the bump now.

package/commands/claude/reference.md

@@ -0,0 +1,42 @@
+Load Claude Code CLI reference documentation for implementation guidance.
+
+## Reference Documentation
+
+The following documentation files in `doc/cli/` provide comprehensive reference for Claude Code implementation:
+
+| File | Content |
+|------|---------|
+| `settings.md` | settings.json format, scopes, permissions syntax |
+| `hooks.md` | Hooks reference (events, matchers, configuration) |
+| `tutorial.md` | Hooks getting started guide |
+| `plugins.md` | Plugin system reference |
+| `iam.md` | Identity, authentication, access management |
+| `capabilities.md` | Tool capabilities |
+| `structure.md` | Directory structure conventions |
+| `sdk.md` | SDK protocols |
+| `overview.md` | General overview |
+
+## Usage
+
+When the user invokes `/claude:reference`, read the relevant documentation files from `doc/cli/` based on what they're trying to implement:
+
+- **Settings/permissions**: Read `doc/cli/settings.md`
+- **Hooks**: Read `doc/cli/hooks.md` and `doc/cli/tutorial.md`
+- **Plugins**: Read `doc/cli/plugins.md`
+- **Authentication**: Read `doc/cli/iam.md`
+- **General questions**: Read `doc/cli/overview.md`
+
+If no specific topic is mentioned, provide a summary of available documentation and ask what aspect they need help with.
+
+## Example
+
+```
+User: /claude:reference settings permissions
+Action: Read doc/cli/settings.md, focus on permissions section
+
+User: /claude:reference hooks
+Action: Read doc/cli/hooks.md and doc/cli/tutorial.md
+
+User: /claude:reference
+Action: List available topics and ask for clarification
+```

package/commands/pricing.md

@@ -0,0 +1,16 @@
+Show pricing analysis and competitor comparison.
+
+Run `hu data pricing` to show:
+- Your subscription cost vs API equivalent cost
+- Break-even analysis for Max tiers
+- Competitor pricing comparison
+
+Options:
+- `-s, --subscription` - Your Claude subscription (free, pro, max5x, max20x)
+- `-j, --json` - Output as JSON
+
+```bash
+hu data pricing
+hu data pricing -s pro
+hu data pricing -j
+```

package/commands/publish.md

@@ -0,0 +1,20 @@
+Publish package to npm registry.
+
+## Command
+
+```bash
+npm publish --access public --tag alpha
+```
+
+This publishes the package with:
+- `--access public` - makes the scoped package publicly accessible
+- `--tag alpha` - tags as alpha release (required for prerelease versions)
+
+## Before Publishing
+
+Ensure you have:
+1. Bumped the version (`/bump` or `hu bump run`)
+2. Committed and pushed all changes
+3. Logged into npm (`npm login`)
+
+Run the publish now.

package/doc/PRICING.md

@@ -0,0 +1,171 @@
+---
+source: https://claude.com/pricing, https://github.com/features/copilot, https://cursor.com/pricing, https://windsurf.com/pricing, https://tabnine.com/pricing, https://aws.amazon.com/q/developer/pricing/
+fetched: 2026-01-14
+---
+
+# AI Coding Assistant Pricing Comparison
+
+This document tracks pricing for AI coding assistants and Claude API costs.
+
+## Claude (Anthropic)
+
+### Subscriptions
+
+| Plan | Price | Usage |
+|------|-------|-------|
+| Free | $0/month | Basic usage |
+| Pro | $20/month ($17 annual) | More usage than Free, Claude Code access |
+| Max 5x | $100/month | 5x Pro usage |
+| Max 20x | $200/month | 20x Pro usage |
+| Team Standard | $30/month ($25 annual) | Per seat, min 5 members |
+| Team Premium | $150/month | Per seat, includes Claude Code |
+| Enterprise | Custom | Contact sales |
+
+### API Pricing (per million tokens)
+
+| Model | Input | Output | Cache Write | Cache Read |
+|-------|-------|--------|-------------|------------|
+| Opus 4.5 | $5.00 | $25.00 | $6.25 | $0.50 |
+| Sonnet 4.5 | $3.00 | $15.00 | $3.75 | $0.30 |
+| Haiku 4.5 | $1.00 | $5.00 | $1.25 | $0.10 |
+| Opus 4 | $15.00 | $75.00 | - | - |
+| Sonnet 4 | $3.00 | $15.00 | - | - |
+| Sonnet 3.5 | $3.00 | $15.00 | - | - |
+| Haiku 3 | $0.25 | $1.25 | - | - |
+
+---
+
+## GitHub Copilot
+
+### Individual Plans
+
+| Plan | Price | Limits |
+|------|-------|--------|
+| Free | $0/month | 2,000 completions/month, 50 chat requests/month |
+| Pro | $10/month ($100/year) | Unlimited completions, 300 premium requests/month |
+| Pro+ | $39/month ($390/year) | 1,500 premium requests/month, Claude Opus 4.1 access |
+
+### Business Plans
+
+| Plan | Price | Limits |
+|------|-------|--------|
+| Business | $19/user/month | Unlimited completions, 300 premium requests/month |
+| Enterprise | $39/user/month | 1,000 premium requests/month, all models |
+
+**Notes:**
+- Premium requests are for latest models (Claude, GPT-5, etc.)
+- Agent mode with GPT-5 mini is unlimited on paid plans
+- Free tier includes Haiku 4.5, GPT-4.1
+
+---
+
+## Cursor
+
+### Individual Plans
+
+| Plan | Price | Features |
+|------|-------|----------|
+| Hobby (Free) | $0/month | Limited Agent requests, limited Tab completions |
+| Pro | $20/month | Extended Agent limits, unlimited Tab completions, Background Agents |
+| Pro+ | $60/month | 3x usage on all models (OpenAI, Claude, Gemini) |
+| Ultra | $200/month | 20x usage on all models, priority feature access |
+
+### Business Plans
+
+| Plan | Price | Features |
+|------|-------|----------|
+| Teams | $40/user/month | Shared chats, usage analytics, SSO, RBAC |
+| Enterprise | Custom | Pooled usage, SCIM, audit logs, priority support |
+
+### Bugbot Add-on
+
+| Plan | Price | Limits |
+|------|-------|--------|
+| Free | $0/month | Limited code reviews/month |
+| Pro | $40/user/month | Unlimited reviews on up to 200 PRs/month |
+| Teams | $40/user/month | Unlimited reviews on all PRs |
+
+---
+
+## Windsurf (formerly Codeium)
+
+| Plan | Price | Credits | Notes |
+|------|-------|---------|-------|
+| Free | $0/month | 25 prompt credits | Basic access |
+| Pro | $15/month | 500 prompt credits | +$10 for 250 additional credits |
+| Teams | $30/user/month | 500 credits/user | +$10/user for enhanced features |
+| Enterprise | Custom | 1,000 credits/user | Volume discounts, hybrid deployment |
+
+**Notes:**
+- Credits consumed when using premium models in Cascade
+- Cost varies by model selected
+- Unlimited Tabs, Previews, and Deploys on all plans
+
+---
+
+## Tabnine
+
+| Plan | Price | Features |
+|------|-------|----------|
+| Agentic Platform | $59/user/month (annual) | AI completions, chat, workflow agents |
+
+**Notes:**
+- Single plan with comprehensive features
+- Unlimited usage when using your own LLM
+- 5% handling fee on Tabnine-provided LLM access
+- Zero code retention, end-to-end encryption
+- Flexible deployment: SaaS, VPC, on-premises, air-gapped
+
+---
+
+## Amazon Q Developer
+
+| Plan | Price | Limits |
+|------|-------|--------|
+| Free | $0/month | 50 agentic requests/month, 1,000 lines Java upgrade |
+| Pro | $19/user/month | 4,000 lines/month (pooled), overage $0.003/line |
+
+**Notes:**
+- Subscriptions activate upon actual use, not sign-in
+- Pro includes IP indemnity and automatic data opt-out
+- Access to latest Claude models included
+
+---
+
+## Quick Comparison (Monthly Individual Plans)
+
+| Service | Free | Basic Paid | Pro/Advanced |
+|---------|------|------------|--------------|
+| Claude Max | - | $100 (5x) | $200 (20x) |
+| GitHub Copilot | $0 (limited) | $10 | $39 |
+| Cursor | $0 (limited) | $20 | $60-200 |
+| Windsurf | $0 (25 credits) | $15 | - |
+| Tabnine | - | $59 | - |
+| Amazon Q | $0 (50 requests) | $19 | - |
+
+---
+
+## Value Analysis
+
+### Claude Max at $200/month equivalent usage
+
+Based on typical heavy usage (example: ~2.3M output tokens with Opus 4.5):
+- **API equivalent cost:** ~$60 for this session data
+- **Max subscription:** $200/month flat
+- **Break-even point:** ~7.7M output tokens/month with Opus 4.5
+
+### Cost per 1M tokens (output) comparison
+
+| Service | Approx. Cost |
+|---------|--------------|
+| Claude API (Opus 4.5) | $25.00 |
+| Claude API (Sonnet 4.5) | $15.00 |
+| Claude API (Haiku 4.5) | $5.00 |
+| GitHub Copilot Pro | ~$10/month flat |
+| Cursor Pro | ~$20/month flat |
+
+*Note: Subscription services don't expose per-token costs, making direct comparison difficult.*
+
+---
+
+*Last updated: 2026-01-14*