PirateBao
PirateBao be a Bun-first, TypeScript-first pirate rig for terse AI coding replies. Commands, code, paths, versions, risk notes, stack traces, and test results stay nailed to the mast. Greeting foam, hedge fog, and apology barnacles get keelhauled on sight. Kraken eats boilerplate; cargo stays lashed. Parrot squawks; token bill shrinks.
Default sail: kraken. Main flags: /piratebao, $piratebao, /piratebao:compress. Goal: fewer tokens, same technical cargo, less polite sea-tax.
Explain Like I'm 5
AI answers spend doubloons on hello, read the map thrice, then polish the plank until the plank demands equity. PirateBao heaves chatter overboard and lashes treasure to the mast: command, file, bug, fix.
| Before | After |
|---|
| "Sure, I would be happy to help. The issue is likely caused by a new object reference on each render." | "New object ref each render. Use useMemo." |
Same treasure map. Smaller scroll. Faster ship. Fewer invoices dressed as parrots. No "hope this helps" barnacle unless it actually fixes the failing test. Politeness is ballast; the kraken knows what to eat.
flowchart LR
A["Long answer"] --> B["PirateBao removes ceremony"]
B --> C["Short technical answer"]
C --> D["Fewer tokens"]
D --> E["Lower cost + faster replies"]
What It Ships
| Area | Contract |
|---|
| Runtime | Claude Code hooks compile to dist/hooks/*.js; session start hauls no tsx anchor. |
| Skills | Canonical behavior lives in skills/piratebao/SKILL.md; copies synced and verified — drift walks the plank. |
| Compression | /piratebao:compress <file> uses Anthropic SDK, preserves code/URLs/paths/headings, writes .original.md backup. |
| OpenCode | Native .opencode/skills/<name>/SKILL.md and .opencode/commands/*.md; no plugin dependency in this pass. |
| npmjs | package.json exports compiled TypeScript cargo and gates the payload with npm pack --dry-run --json. No imaginary barrels aboard. |
.bao | bao/piratebao.manifest.json is a cargo ledger, not an archive format. The quartermaster checks it. |
What It Does Not Ship
| Not aboard | Reason |
|---|
| Legacy aliases | Break rename is intentional. Old names are barnacles — scrape them. |
| CLI fallback for compression | Missing ANTHROPIC_API_KEY fails directly. Ghost oars cost maintenance and sometimes row toward prod. |
.bao archive builder | This pass counts barrels and checks labels only. No archive builder lurks below deck. |
| Runtime TypeScript loader for hooks | Hooks run compiled JS. Ship does not stop to compile at dawn. |
日本語 README
PirateBao
PirateBao は Bun-first / TypeScript-first の海賊リグです。AI コーディング返答から挨拶の泡、遠慮の霧、謝罪のフジツボを斬り捨てます。コード、コマンド、パス、バージョン、危険、スタックトレース、テスト結果はマストに釘打ちます。クラーケンは boilerplate を食べ、TypeError は残します。オウムは騒ぐ。token は金貨。礼儀に銀貨を払う船長はおらぬ。
5歳向け説明
AI は宝箱の前で長々と挨拶し、地図を三度読み直し、甲板を磨いて磨いて磨きがちです。PirateBao は泡を海に捨て、宝だけマストに残します: コマンド、ファイル、バグ、修正。金貨で霧を買わぬ。海賊は礼儀に銀を払わぬ。
flowchart LR
A["長い返答"] --> B["前置きを捨てる"]
B --> C["短い技術返答"]
C --> D["token削減"]
D --> E["速い航海"]
技術メモ
| 項目 | 内容 |
|---|
| 既定の帆 | kraken |
| 主要コマンド | /piratebao, /piratebao:compress <file>, /piratebao-help |
| 日本語モード | nihon-skiff, nihon-brig, nihon-kraken |
| 検証 | bun run check が TypeScript、Vitest、.bao、OpenCode、npmjs dry-run を通す |
| 積荷台帳 | bao/piratebao.manifest.json に README と OpenCode 積荷を載せる |
bun install --frozen-lockfile
bun run check
船長向け結論: これは翻訳された飾りではなく、日本語の短縮モードと検証対象の README です。nihon-kraken は短く切る。rm -rf と npm publish の危険は切りすぎない。髑髏は少なめ、検証は多め。
Schwiizerdütsch README
PirateBao
PirateBao isch es Bun-first, TypeScript-first Pirat-Rigg für churzi AI-Coding-Antworte. Code, Befehle, Pfäd, Versione, Risiko, Stacktraces und Testresultat bliibe am Mascht feschtgnaglet. Begrüessigs-Schaum, Hättegli-Nebel und Entschuldigungsmuschele gönd über Bord — kielholt ohni Gnade. De Chrottekrake frisst Boilerplate, nöd Fehlermeldige. De Papagei chiflet; d token-Rechnig schrumpft. Höflichkeit isch Ballascht.
Für Chind erklärt
AI redt mängisch hoi, list d Charte drüümal und poliert s Brett bis es nach Büro riecht. PirateBao seit: Ladig bhalte, Blabla ab is Wasser. Tokens sind Münze; mir zahled nöd für Nebel mit Schnauz. De Hafemeister nickt; de Papagei chrächzt.
flowchart LR
A["Langi Antwort"] --> B["Blabla usem Logbuech streiche"]
B --> C["Kurzi Technik-Antwort"]
C --> D["weniger Tokens"]
D --> E["schnäller Hafe"]
Technik
| Teil | Sinn |
|---|
| Standard-Segel | kraken |
| Befehle | /piratebao, /piratebao:compress <file>, /piratebao-help |
| Schwiizerdütsch-Modi | swiss-skiff, swiss-brig, swiss-kraken |
| Gate | bun run check prüeft TypeScript, Vitest, .bao, OpenCode und npmjs dry-run |
| Ladigslischte | bao/piratebao.manifest.json listet README und OpenCode-Fracht |
