All shelves / Mods / Workflow
credo
By Marcel-Bich
credo is a Claude Code workflow mod by Marcel-Bich.
A framework of work items, roles, and modes for running sessions, with an optional band above the prompt for the mode and the item counts.
Draws
Install
The marketplace name is marcel-bich-claude-marketplace.
claude plugin marketplace add Marcel-Bich/marcel-bich-claude-marketplace claude plugin install credo@marcel-bich-claude-marketplace
It runs inside the Claude Code process. The side panel is only what the author's README names. Read the repo before you install, or run claude plugin validate on the plugin folder.
- Version
- 0.84.0
- License
- MIT
- Repo stars
- 12
- Last change
- 2026-10-16
What it can reach
- Draws in the session
- Reads usage or context figures
- Reaches the network or an outside service
- Calls another program on this machine
The plugin README's Installation section has no fence. The lines above are the repository README's Quick Start. That fence also installs the marketplace's other plugins. This page copies only the credo line. Then run /credo:setup to initialize a project. All plugins need jq. Supported on Linux, macOS, and WSL2, not native Windows. Run Claude Code inside tmux. Self-compact and self-reload only work in a tmux pane, and setup runs a package install only after your yes. When credo runs inside Claude Code with mods support, a small band above the prompt draws. It is optional. It only reads credo's state through the core scripts and renders it. The core, hooks, scripts, skills, and items, works the same without it. Without a credo project the item counts and the item controls are left out. The session line still shows the mode when there is one. The autonomy line shows only while this session runs autonomously: the 5-hour utilization, the next ladder rung, and the next wake time. Those figures need the limit plugin. If limit is absent, the budget features are silently unavailable. A self-restart that is pending draws a notice on the band until you cancel it, it relaunches, or it fails. /credo-items opens the items pane. The band refreshes on session start, after Bash calls, at turn end, and every 10 seconds. In autonomous mode, ntfy sends immediate come-to-PC pushes for questions, blockers, and completion, plus a content-rich progress digest on a fixed interval, to the ntfy topic you set. The optional LAN peer relay publishes this machine's sessions to the peers you configure over TCP, without the Anthropic cloud. The framework can type into this session's own tmux pane for reload, compact, and restart.
The marketplace name is marcel-bich-claude-marketplace. The same marketplace also lists dogma, signal, limit, hydra, import, get-shit-done, and marketplace. The band is not a hold. The ntfy pushes, the relay, and the tmux typing are the framework, not the band.
Demo

What it hooks into
session.startWhen a session startstool.callAround a tool call, where it can hold oneturn.completeWhen a turn endsui.renderDraws into the sessionPromptHintPaneAbovePromptcommand.runWhen you run its slash command/credo-items
Read from the on() calls in its hook modules. Open its source under Files to check what each one does.
Slash commands 1
/credo-itemsShow credo items per status in a pane
Hooks 34
PreToolUse · Task|Agent|Bash|Edit|Write|MultiEdit|NotebookEdit|WebFetch|WebSearch${CLAUDE_PLUGIN_ROOT}/scripts/credo-5h-budget-guard.shPreToolUse · Bash${CLAUDE_PLUGIN_ROOT}/hooks/credo-item-move-guard.shPreToolUse · Bash${CLAUDE_PLUGIN_ROOT}/hooks/credo-wait-hint.shPreToolUse · SendMessage|Bash|Write|Edit|MultiEdit${CLAUDE_PLUGIN_ROOT}/hooks/credo-peer-message.shSessionStart${CLAUDE_PLUGIN_ROOT}/hooks/credo-session-start.shSessionStart${CLAUDE_PLUGIN_ROOT}/hooks/credo-peer-bridge.shSessionStart${CLAUDE_PLUGIN_ROOT}/hooks/credo-peer-lan-autostart.shSessionStart${CLAUDE_PLUGIN_ROOT}/scripts/credo-unblock-sweep.shSessionStart${CLAUDE_PLUGIN_ROOT}/hooks/credo-optimize-hook.shSessionStart${CLAUDE_PLUGIN_ROOT}/hooks/credo-todo-tools-hint.shSessionStart${CLAUDE_PLUGIN_ROOT}/hooks/credo-session-dir-record.shSessionStart${CLAUDE_PLUGIN_ROOT}/hooks/credo-peer-split-hint.shSessionStart${CLAUDE_PLUGIN_ROOT}/hooks/credo-permission-mode-record.shSessionStart${CLAUDE_PLUGIN_ROOT}/hooks/credo-peer-meta-record.shUserPromptSubmit${CLAUDE_PLUGIN_ROOT}/hooks/session-mode-inject.shUserPromptSubmit${CLAUDE_PLUGIN_ROOT}/hooks/role-inject.shUserPromptSubmit${CLAUDE_PLUGIN_ROOT}/hooks/credo-datetime-inject.shUserPromptSubmit${CLAUDE_PLUGIN_ROOT}/hooks/credo-attended-reminder.shUserPromptSubmit${CLAUDE_PLUGIN_ROOT}/hooks/credo-skill-nudge.shUserPromptSubmit${CLAUDE_PLUGIN_ROOT}/hooks/credo-plugin-freshness-inject.shUserPromptSubmit${CLAUDE_PLUGIN_ROOT}/hooks/credo-autonomy-clear.shUserPromptSubmit${CLAUDE_PLUGIN_ROOT}/hooks/credo-peer-message.shUserPromptSubmit${CLAUDE_PLUGIN_ROOT}/hooks/credo-peer-bridge.shUserPromptSubmit${CLAUDE_PLUGIN_ROOT}/hooks/credo-optimize-hook.shUserPromptSubmit${CLAUDE_PLUGIN_ROOT}/hooks/credo-permission-mode-record.shUserPromptSubmit${CLAUDE_PLUGIN_ROOT}/hooks/credo-peer-meta-record.shPostToolUse · *${CLAUDE_PLUGIN_ROOT}/hooks/credo-datetime-inject.shPostToolUse · *${CLAUDE_PLUGIN_ROOT}/hooks/credo-skill-nudge.shPostToolUse · *${CLAUDE_PLUGIN_ROOT}/hooks/credo-plugin-freshness-inject.shPostToolUse · *${CLAUDE_PLUGIN_ROOT}/hooks/credo-peer-bridge.shPostToolUse · .*browser_take_screenshot${CLAUDE_PLUGIN_ROOT}/hooks/credo-screenshot-relocate.shSubagentStart${CLAUDE_PLUGIN_ROOT}/hooks/credo-subagent-inject.shStop${CLAUDE_PLUGIN_ROOT}/hooks/credo-autonomy-keepalive.shNotification · permission_prompt${CLAUDE_PLUGIN_ROOT}/hooks/credo-autonomy-permission-notify.sh
Files
The author's README and source, 4 files. They load when you open them.
Facts
- Author
- Marcel-Bich
- Category
- Workflow
- Marketplace
- marcel-bich-claude-marketplace
- Folder
- plugins/credo
- Version
- 0.84.0
- License
- MIT
- Repo stars
- 12
- Last change
- 2026-10-16
- Language
- Shell
- Files
- 171