Few-Word
sheeki03 · sheeki03/Few-Word
This Claude Code plugin automatically offloads large command outputs to the filesystem, keeping the agent's context clean and optimizing token usage.
Claude Code plugin that offloads large outputs to filesystem and retrieves when required.
Preview
What you can do with it
- Prevent large test suite outputs from consuming excessive context tokens during debugging.
- Improve agent performance by reducing the amount of irrelevant information in the active context.
- Enable an agent to retrieve full logs or detailed reports from disk only when specifically required.
Safety check
Usable, but read the notes first.
- ●No clear license: check with the author before using it in a commercial product.
Automated scan of the repo files. Always review code you run.
From the README
FewWord
"Why waste time say lot word when few word do trick? Big output go file. Small word stay. Context happy. Me happy. Everyone go home by seven."
— Kevin Malone
A Claude Code plugin that automatically offloads large command outputs to files, keeping your context clean and retrievable.
The Problem
AI coding agents hit a wall when:
- Tool outputs bloat your context — One big test run or log dump eats 10k tokens that sit there forever
- Plans get lost — After context summarization, Claude forgets what it was doing
- You're paying for waste — Most of your context is irrelevant to the current step
The Solution
FewWord implements dynamic context discovery — patterns from Manus and LangChain that use the filesystem as infinite, searchable memory.
Instead of this:
[26,000 tokens of command outputs sitting in context forever]
You get this (~35 tokens):
[fw A1B2C3D4] find e=0 15K 882L | /open A1B2C3D4
For failures, you also get a preview:
[fw E5F6G7H8] pytest e=1 45K 234L | /open E5F6G7H8
FAILED test_auth.py::test_login - AssertionError
FAILED test_api.py::test_endpoint - TimeoutError
2 failed, 48 passed in 12.34s
How It Works
┌─────────────────────────────────────────────────────────────────┐
│ Claude Code Session │
├─────────────────────────────────────────────────────────────────┤
│ │
│ You: "Run the test suite" │
│ │ │
│ ▼ │
│ ┌──────────────────────────────────────────┐ │
│ │ PreToolUse Hook Intercepts │ │
│ │ ───────────────────────── │ │
│ │ Command: pytest │ │
│ │ Output: 45,678 bytes (>8KB threshold) │ │
│ └──────────────────────────────────────────┘ │
│ │ │
│ ┌───────────────┴───────────────┐ │
│ ▼ ▼ │
│ ┌─────────────────────┐ ┌─────────────────────────┐ │
│ │ Write to Disk │ │ Return to Context │ │
│ │ ───────────────── │ │ ──────────────────── │ │
│ │ .fewword/scratch/ │ │ File: pytest_143022.txt│ │
│ │ tool_outputs/ │ │ Size: 45KB, Exit: 1 │ │
│ │ pytest_143022.txt │ │ === Last 10 lines === │ │
│ │ │ │ FAILED auth_test... │ │
│ │ [Full 45KB output] │ │ [~200 tokens only] │ │
│ └─────────────────────┘ └─────────────────────────┘ │
│ │
│ Later: "What tests failed?" │
│ │ │
│ ▼ │
│ Claude: grep FAILED .fewword/scratch/tool_outputs/pytest.txt │
│ → Retrieves exactly what's needed │
│ │
└─────────────────────────────────────────────────────────────────┘
Result: 45KB output → ~35 tokens in context + full data on disk when needed.
Test Results
We ran the same 3 commands (find, ls -la, env) in two fresh Claude Code sessions:
| Metric | WITH Plugin | WITHOUT Plugin |
|---|---|---|
| Message Tokens | 4.7k | 26.0k |
| Tokens Saved | 21.3k | — |
| Savings | 82% | — |
Understanding the Numbers
When you run /context, you see several categories:
Total Context: 84k tokens (with plugin) vs 105k tokens (without)
├── System prompt: 3.8k (constant - Claude's instructions)
├── System tools: 15.8k (constant - built-in tools)
├── MCP tools: 14.7k (constant - browser automation, etc.)
├── Messages: 4.7k ← THIS IS WHAT FEWWORD REDUCES (was 26k)
└── Free space: ...
The 82% savings (21.3k tokens) is specifically on Message tokens — that's where your actual conversation and command outputs live.
Installation
Step 1: Add the marketplace
claude plugin marketplace add sheeki03/Few-Word
Step 2: Install the plugin
claude plugin install fewword@sheeki03-Few-Word
Step 3: Start a new session for hooks to load.
That's it! FewWord works automatically — no configuration needed.
Alternative: Install from inside Claude Code
You can also run these commands inside an active Claude session:
/plugin marketplace add sheeki03/Few-Word
/plugin install fewword@sheeki03-Few-Word
Then start a new session.
Updates
FewWord checks for updates automatically on session start. Notifications are rate-limited (at most once every 24 hours).
To update manually:
claude plugin update fewword@sheeki03-Few-Word
Then start a new session for hooks to reload.
Check your version: /version
Disable update checks: export FEWWORD_DISABLE_UPDATE_CHECK=1
Commands
| Command | What It Does |
|---|---|
/help | Show detailed help and how the plugin works |
/stats | Show session statistics and estimated token savings |
/version | Show installed version and update command |
/open <id> | Retrieve an offloaded output by ID |
/recent | Show recent offloaded outputs (recovery after compaction) |
/pin <id> | Pin an output to prevent auto-clea |