fiche v0.17.0
GitHub

v0.17.0 · macOS · Linux · Windows · Docker · Workers · MIT

Microfiche for Coding Agents

A local, cache-safe hybrid optical and 4-layer deterministic text context compiler. Compresses verbose tool schemas, ANSI build spam, and multi-turn logs into dense microfiche plates or byte-exact @toon deltas — keeping numbered reads and diffs 100% editSafe.

npm install -g github:sriinnu/fiche
Drag anywhere on darkroom canvas to stir context filaments WebGL2 GPU
TOKENS SAVED 35.1–51.9% across 16 models · 16-turn bench
REAL USD SAVED 27.9–40.8% text tier + Fable / Gemini optical
KV CACHE HIT 80.9–90.9% append-only prefix seal
WARM P50 LATENCY 1.2–3.3 ms loopback transform overhead
EDIT FIDELITY 100% EDITSAFE 16 / 16 models · diffs byte-exact
01 / PIPELINE

Optical Split Curtain & 6-Stage Signal Bus

Every request enters at 127.0.0.1:47821 (or offline via fiche export / fiche-mcp), routes by model capability in readerTier(), and seals completed epochs behind an immutable KV prefix boundary.

BEFORE · RAW SESSION 47,800 tok AFTER · COMPILED FICHE 26,200 tok · -45.2% · 90.9% KV cache
WIRE INBOUND · UNCOMPRESSED ANSI + \r progress + verbose JSON schemas + repeated logs
// Turn 1..14 static tool schemas (14,200 tok repeated verbatim)
{"name":"read_file","description":"Read file from workspace with optional line range...","parameters":{"type":"object","properties":{"path":{"type":"string"},"start":{"type":"integer"}}}}
{"name":"run_command","description":"Execute shell command in workspace..."}

\x1b[33m⠋ Compiling 184 TypeScript modules...\x1b[0m\r\x1b[2K\x1b[33m⠙ Compiling 184 TypeScript modules...\x1b[0m\r\x1b[2K
src/core/proxy.ts(142,19): error TS2345: Argument of type 'Buffer' is not assignable to parameter of type 'Uint8Array'.
[11:42:01.004] GET /v1/messages 200 1.4ms
[11:42:01.112] GET /v1/messages 200 1.3ms
[11:42:01.240] GET /v1/messages 200 1.5ms  (×48 repeated heartbeat rows)

--- a/src/core/proxy.ts
+++ b/src/core/proxy.ts
@@ -140,4 +140,4 @@
-  return digestChunk(rawBody);
+  return digestChunk(new Uint8Array(rawBody));
OPTICAL MICROFICHE + @TOON + EDITSAFE Sealed turns 1..14 · live tail preserved
@tscg.tools[2]{name,req}: read_file,path; run_command,cmd
[fiche:plate#01 312×120 spleen-5x8 · turns 1..14 sealed]
▸ TS2345 src/core/proxy.ts:142 Buffer -> Uint8Array
▸ drain[×48]: GET /v1/messages 200 <ms> (kept errors)
▸ casi_delta: 0 new lines in unchanged config blocks

/* editSafe guard: active diff & numbered reads UNTOUCHED */
--- a/src/core/proxy.ts
+++ b/src/core/proxy.ts
@@ -140,4 +140,4 @@
-  return digestChunk(rawBody);
+  return digestChunk(new Uint8Array(rawBody));
SIGNAL BUS · STAGE INSPECTOR

Anthropic Fable 5 · Optical Tier

Wire: anthropic Tokens: -43.6% USD: -34.6% Warm p50: 2.75 ms
STAGE 01 · TSCG ACTIVE 0.24 ms p50

STAGE INPUT
STAGE OUTPUT
02 / OPTICAL LAB

Physical Microfiche Reader Bay

Explore how render.ts packs dense agent traces onto a 312-column Spleen 5×8 microfiche plate with a live 2.5× optical loupe, verbatim FactSheet anchors, and stage waterfall.

FRAME 01 · 312 COLS · SPLEEN 5×8 R20:C110 · 2.5× LOUPE Hover / drag plate · Arrow keys pan loupe
03 / BENCHMARK & ECONOMICS

16-Model Pareto Frontier & Team Savings Calculator

Every figure is loaded directly from bench-results.generated.json (snapshot 2026-11-21, 16-turn agent workload, editSafe: true on all 16 models).

PARETO FRONTIER · EFFICIENCY VS TRANSFORM LATENCY

Tokens Saved % vs Avg Transform Time (ms)

Optical Tier 4-Layer Text

Dashed line traces the non-dominated Pareto frontier. Hover or tap any point to inspect KV cache hit, p95 latency, and wire mode.

ALL 16 MEASURED MODELS · 16-TURN WORKLOAD Click column headers to sort
editSafe
grok-4.7xAI4-Layer Text44.5%40.8%90.9%1.32.5yes
glm-5.3z.ai4-Layer Text44.6%40.1%90.9%1.42.3yes
deepseek-v4-proDeepSeek4-Layer Text44.6%37.9%90.9%1.52.7yes
gpt-6-astraOpenAI / Codex4-Layer Text44.5%36.7%90.9%3.312.7yes
gpt-6.2-astraOpenAI / Codex4-Layer Text44.5%35.5%90.9%1.52.6yes
claude-opus-5-5Anthropic4-Layer Text44.5%35.5%90.8%1.63.2yes
kimi-k3Moonshot4-Layer Text44.6%35.0%90.9%1.63.1yes
claude-fable-5-20260609AnthropicOptical43.6%34.6%90.0%6.938.2yes
gemini-4-carbonGoogle / AGY4-Layer Text44.9%33.4%90.9%1.52.8yes
gemini-4-hydrogenGoogle / AGY4-Layer Text44.9%33.4%90.9%1.42.7yes
gemini-3.1-pro-previewGoogle / AGY4-Layer Text44.9%33.3%90.9%1.22.2yes
gemini-3.8-flashGoogle / AGYOptical51.9%28.8%84.0%9.439.7yes
gemini-4-argonGoogle / AGYOptical39.7%27.9%90.0%10.543.3yes
gpt-5.6-solOpenAI / CodexOptical35.1%5.0%80.9%10.029.1yes
gpt-6.2-solOpenAI / CodexOptical35.1%-1.4%80.9%15.391.6yes
gemini-4-neonGoogle / AGY4-Layer Text44.9%n/a90.9%2.05.3yes
04 / MACOS COMPANION

FicheBar.app — Zero-Token Menubar Telemetry

Native Swift 6 / SwiftUI menubar companion polling local 127.0.0.1:47821 with zero LLM tokens, 5 Apple HIG themes, weighted vs raw savings clarity, and 1-click third-party model controls.

5 Native Themes
Switch between Editorial, Native, Slate, Terminal, and Midnight — synced to SwiftUI tokens.
Weighted vs Raw Clarity
Inspect per-model 16-turn token & USD savings, prefix-cache hit percentage, and active pipeline stages live.
Desktop App Proxy Launcher
Wrap GUI apps via fiche warp --app or toggle third-party compatibility hosts and telemetry plugins with one click.
Zero Background Telemetry
Reads ~/.fiche/events.jsonl and local HTTP endpoints only; never touches remote servers.
05 / DEPLOYMENT MATRIX

2-Axis OS × Agent Configurator

Select your host environment and coding agent to generate verified loopback, TLS warp, shell-init, MCP, Docker, Cloudflare Workers, or offline export commands.

macOS · Antigravity

Loopback Proxy + Antigravity Telemetry Plugin

127.0.0.1:47821

Route Antigravity traffic through the local fiche proxy or wrap the CLI with HTTPS CONNECT warp, and wire the zero-token PostInvocation hook.

CROSS-PLATFORM CORE

Included everywhere (macOS · Linux · Windows / WSL · Docker · Workers)

  • Loopback proxy daemon (fiche on 127.0.0.1:47821) & Warm Paper web dashboard
  • 4-layer deterministic text compiler (TSCG, ANSI/CR, @toon, Drain, ACDC, CASI-Delta)
  • Optical microfiche PNG renderer (Spleen 5×8 + GNU Unifont + JetBrains Mono)
  • HTTPS CONNECT interceptor (fiche warp -- <cli>) & fiche-mcp (stdio / :47823)
  • Offline generator (fiche export) & fast reverse-tail CLI (fiche turn-report, fiche stats)
OPTIONAL MACOS EXTRAS

Native macOS integration (never required for core)

  • FicheBar.app — Swift 6 / SwiftUI menubar monitor & controller
  • GUI Desktop App Launcher — fiche warp --app <Name> for Electron / native IDEs
  • launchd Service Manager — fiche service install background daemon supervision
  • Shell Init Wrappers — fiche shell-init --wrap (fclaude, fcodex, fiche-app)