npx chisleDetects supported agents and installs Chisle for each:
| Agent | What gets installed | Scope |
|---|---|---|
| Claude Code | plugin, or standalone hooks + statusline fallback | global |
| Pi | package containing extension + skill | global |
| Gemini CLI | Gemini extension | global |
| Codex | fenced ruleset in ~/.codex/AGENTS.md |
global |
| OpenCode | fenced ruleset in ~/.config/opencode/AGENTS.md + skills in ~/.config/opencode/skills + compression plugin in ~/.config/opencode/plugins |
global |
| Hermes Agent | skills in ~/.hermes/skills (Agent Skills standard, /chisle commands) |
global |
| Cursor / Windsurf / Cline / Kiro / Copilot | rule file in current project | project |
npx chisle --list # detect only
npx chisle --only pi # one agent; repeatable
npx chisle --dry-run # preview without mutation
npx chisle --stats # tool-output savings so far; read-only
npx chisle@latest --update # refresh what is installed; add nothing new
npx chisle --force # reinstall / overwrite
npx chisle --uninstall # remove everything installed
npx chisle -u --only pi # remove only Pi packageShell launchers forward the same flags:
curl -fsSL https://raw.githubusercontent.com/JayPokale/Chisle/main/install.sh | bashirm https://raw.githubusercontent.com/JayPokale/Chisle/main/install.ps1 | iexclaude plugin marketplace add JayPokale/Chisle
claude plugin install chisle@chisleRestart Claude Code. Chisle activates automatically.
pi install npm:chisle
# or directly from Git:
pi install git:github.com/JayPokale/ChislePi loads pi-extension/index.js and skills/chisle/SKILL.md from the package. The extension supplies always-on rules, /chisle, the status badge, and safe tool_result compression. Pi already reads a project's AGENTS.md; when that file contains Chisle, the extension does not inject a duplicate rules message. The skill follows progressive disclosure and is also available as /skill:chisle.
Trust boundary: Pi extensions execute with full user permissions. Review package source before installing. Global packages load for every project. A project-local install:
pi install -l npm:chislewrites .pi/settings.json and loads only after Pi trusts that project.
npx chisle --only opencodeWrites the fenced Chisle ruleset into the global ~/.config/opencode/AGENTS.md
(appended after your existing instructions, never replacing them) and copies the
bundled skills into ~/.config/opencode/skills/ for on-demand loading through
OpenCode's native skill tool. No instructions entry is added, so nothing
loads twice. The ruleset is always on; /chisle loads the skill but does not
toggle the global instructions.
It also installs the tool-output compression plugin into
~/.config/opencode/plugins/ (chisle.js plus its zero-dep compressor core in
chisle-hooks/, pinned to CommonJS so the config dir's type: module does not
propagate into it). OpenCode loads it at startup. It hooks tool.execute.after
(mutating output.output, which persists onto the stored tool part) and
experimental.chat.messages.transform (a request-time safety net over
completed tool parts), eliding oversized explicitly allowed tool output before
the model reads it. OpenCode applies its tool_output line/byte truncation
before tool.execute.after, so Chisle compresses only the retained preview in
that path and preserves OpenCode's full-output recovery hint. MCP tools are not
assumed safe from their names; add known read-only tools with
CHISLE_COMPRESS_TOOLS. Source-bearing and mutating tools remain excluded even
when configured. Disable compression with CHISLE_COMPRESS=0 or
CHISLE_DEFAULT_MODE=off; this does not remove the always-on instructions.
npx chisle --only hermesCopies the bundled skills verbatim into ~/.hermes/skills/ (Agent Skills
standard), where Hermes discovers them as /chisle slash commands. No ruleset
is injected and no config file is rewritten: Hermes already reads project
AGENTS.md, which carries the always-on axis when the repo ships it.
One command covers every agent that already has Chisle:
npx chisle@latest --updateIt refreshes what is installed and adds nothing new. Two details it exists to handle:
- Plain
npx chisledoes not upgrade. Every install path skips what is already present, so an upgrade run reports success and changes nothing. @latestmatters.npxcan serve a cached copy of the package from a previous run; the pin is what guarantees you get the new one.
Add --only <id> to update one agent. The native command is listed where the agent owns its own installer — either works.
| Agent | Update command | Notes |
|---|---|---|
| Claude Code | npx chisle@latest --update --only claudeor claude plugin update chisle@chisle |
Restart the session afterwards. |
| Pi | npx chisle@latest --update --only pior pi install npm:chisle |
Needs pi on PATH, or Chisle reports it as not installed. |
| Gemini CLI | npx chisle@latest --update --only geminior gemini extensions install https://github.com/JayPokale/Chisle |
Needs gemini on PATH. |
| Codex | npx chisle@latest --update --only codex |
Refreshes the fenced block in ~/.codex/AGENTS.md, leaving your own instructions alone. |
| OpenCode | npx chisle@latest --update --only opencode |
Refreshes the ruleset, the skills, and the compression plugin in ~/.config/opencode/plugins/. |
| Hermes Agent | npx chisle@latest --update --only hermes |
Refreshes the skills in ~/.hermes/skills/. |
| Cursor | npx chisle@latest --update --only cursor |
Run inside the project. |
| Windsurf | npx chisle@latest --update --only windsurf |
Run inside the project. |
| Cline | npx chisle@latest --update --only cline |
Run inside the project. |
| Kiro | npx chisle@latest --update --only kiro |
Run inside the project. |
| GitHub Copilot | npx chisle@latest --update --only copilot |
Run inside the project. |
The last five keep their rule file inside the repo, because that is how those agents load rules. --update looks for that file in the current directory, so running it from ~ reports "Nothing to update" even when the project is set up correctly. Run it once per repo that has one.
Preview any update without touching disk by adding --dry-run.
Chisle's Claude hook checks npm at session start and mentions major releases once (cached three days). CHISLE_UPDATE_CHECK=0 disables that check.
From 2.x to 3.x, replace legacy lite / full / ultra config with on / off, or remove it.
Claude Code: start a session and run /chisle off, then /chisle.
OpenCode: ~/.config/opencode/AGENTS.md contains the fenced block and /chisle resolves as a skill. ~/.config/opencode/plugins/chisle.js exists and oversized bash/grep/webfetch output is elided in transcripts.
Hermes: ~/.hermes/skills/chisle/SKILL.md exists and /chisle loads the skill.
Pi: start a session. Footer shows [CHISLE]; /chisle off, stop chisle, or normal mode clears it and disables both rules and tool-output compression. /chisle re-enables it. Default mode off only changes session startup behavior.
Pi's default compression allowlist includes bash, powershell, grep, find, ls, and MCP tools. Add extension tools explicitly with CHISLE_COMPRESS_TOOLS. read, edit, and write are always untouched because exact output may feed later edits.
Pi's extension configures its footer badge automatically. Claude Code's standalone fallback configures the bundled statusline when no existing statusline is present. Manual Claude setup:
{
"statusLine": {
"type": "command",
"command": "bash \"/path/to/chisle/hooks/chisle-statusline.sh\""
}
}npx chisle --uninstall
# or Pi only:
pi remove npm:chisle
pi remove git:github.com/JayPokale/ChislePi owns its package entry and cache; pi remove removes both without rewriting unrelated settings.json values. Project-scoped static rule files remain versioned project files and must be removed per repository.
Global AGENTS.md blocks keep surrounding user content: uninstall removes only the fenced <!-- chisle-begin --> … <!-- chisle-end --> block. Skill copies remove only the chisle* skill dirs; foreign skills are untouched.
Resolution: environment → config file → on.
export CHISLE_DEFAULT_MODE=off// ~/.config/chisle/config.json
{ "defaultMode": "off" }Input-axis switches work across Claude Code, Pi, Copilot, and OpenCode where supported:
CHISLE_COMPRESS=0
CHISLE_COMPRESS_SCRUB=0
CHISLE_COMPRESS_DEDUP=0
CHISLE_COMPRESS_MAX_CHARS=8000 # also the final OpenCode output bound
CHISLE_COMPRESS_HEAD_LINES=60
CHISLE_COMPRESS_TAIL_LINES=40
CHISLE_COMPRESS_TOOLS=bash,grepCHISLE_COMPRESS_TOOLS replaces the allowlist. OpenCode defaults to bash,
grep, glob, webfetch, websearch, and list; configure read-only MCP
tools explicitly. The override cannot enable source-bearing or mutating tools
such as read, edit, write, patch, or notebook edits. Their output can
feed later exact-match edits, so this is a correctness guarantee, not a default.