ClaudeCodeMod

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.

In your shell
claude plugin marketplace add Marcel-Bich/marcel-bich-claude-marketplace
claude plugin install credo@marcel-bich-claude-marketplace
Open the repo

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

The credo section on the author's GitHub page
Screenshot of the author's GitHub page.

What it hooks into

  • session.startWhen a session starts
  • tool.callAround a tool call, where it can hold one
  • turn.completeWhen a turn ends
  • ui.renderDraws into the sessionPromptHintPaneAbovePrompt
  • command.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.sh
  • PreToolUse · Bash${CLAUDE_PLUGIN_ROOT}/hooks/credo-item-move-guard.sh
  • PreToolUse · Bash${CLAUDE_PLUGIN_ROOT}/hooks/credo-wait-hint.sh
  • PreToolUse · SendMessage|Bash|Write|Edit|MultiEdit${CLAUDE_PLUGIN_ROOT}/hooks/credo-peer-message.sh
  • SessionStart${CLAUDE_PLUGIN_ROOT}/hooks/credo-session-start.sh
  • SessionStart${CLAUDE_PLUGIN_ROOT}/hooks/credo-peer-bridge.sh
  • SessionStart${CLAUDE_PLUGIN_ROOT}/hooks/credo-peer-lan-autostart.sh
  • SessionStart${CLAUDE_PLUGIN_ROOT}/scripts/credo-unblock-sweep.sh
  • SessionStart${CLAUDE_PLUGIN_ROOT}/hooks/credo-optimize-hook.sh
  • SessionStart${CLAUDE_PLUGIN_ROOT}/hooks/credo-todo-tools-hint.sh
  • SessionStart${CLAUDE_PLUGIN_ROOT}/hooks/credo-session-dir-record.sh
  • SessionStart${CLAUDE_PLUGIN_ROOT}/hooks/credo-peer-split-hint.sh
  • SessionStart${CLAUDE_PLUGIN_ROOT}/hooks/credo-permission-mode-record.sh
  • SessionStart${CLAUDE_PLUGIN_ROOT}/hooks/credo-peer-meta-record.sh
  • UserPromptSubmit${CLAUDE_PLUGIN_ROOT}/hooks/session-mode-inject.sh
  • UserPromptSubmit${CLAUDE_PLUGIN_ROOT}/hooks/role-inject.sh
  • UserPromptSubmit${CLAUDE_PLUGIN_ROOT}/hooks/credo-datetime-inject.sh
  • UserPromptSubmit${CLAUDE_PLUGIN_ROOT}/hooks/credo-attended-reminder.sh
  • UserPromptSubmit${CLAUDE_PLUGIN_ROOT}/hooks/credo-skill-nudge.sh
  • UserPromptSubmit${CLAUDE_PLUGIN_ROOT}/hooks/credo-plugin-freshness-inject.sh
  • UserPromptSubmit${CLAUDE_PLUGIN_ROOT}/hooks/credo-autonomy-clear.sh
  • UserPromptSubmit${CLAUDE_PLUGIN_ROOT}/hooks/credo-peer-message.sh
  • UserPromptSubmit${CLAUDE_PLUGIN_ROOT}/hooks/credo-peer-bridge.sh
  • UserPromptSubmit${CLAUDE_PLUGIN_ROOT}/hooks/credo-optimize-hook.sh
  • UserPromptSubmit${CLAUDE_PLUGIN_ROOT}/hooks/credo-permission-mode-record.sh
  • UserPromptSubmit${CLAUDE_PLUGIN_ROOT}/hooks/credo-peer-meta-record.sh
  • PostToolUse · *${CLAUDE_PLUGIN_ROOT}/hooks/credo-datetime-inject.sh
  • PostToolUse · *${CLAUDE_PLUGIN_ROOT}/hooks/credo-skill-nudge.sh
  • PostToolUse · *${CLAUDE_PLUGIN_ROOT}/hooks/credo-plugin-freshness-inject.sh
  • PostToolUse · *${CLAUDE_PLUGIN_ROOT}/hooks/credo-peer-bridge.sh
  • PostToolUse · .*browser_take_screenshot${CLAUDE_PLUGIN_ROOT}/hooks/credo-screenshot-relocate.sh
  • SubagentStart${CLAUDE_PLUGIN_ROOT}/hooks/credo-subagent-inject.sh
  • Stop${CLAUDE_PLUGIN_ROOT}/hooks/credo-autonomy-keepalive.sh
  • Notification · 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
Repo
Marcel-Bich/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

Other mods in Workflow

handoff-compacttrytofly94Replaces compaction with a structured handoff that a fork of the session writes, and saves that handoff as a file.agentpanexuanji86Draws a side pane of every subagent, with its current tool, tokens, model, and effort, and its conversation one click away.repoqlRepoQLIndexes a repo through the RepoQL host so Claude can search its structure, and draws whether that host is ready or working.nomoreideRorogogogoDraws an optional side pane for NoMoreIDE, a local workbench for Git, services, and agents, by reading its daemon.mods-toolboxrube-deHolds a commandFour mods in one install: a plan checklist above the prompt in place of tool calls and diffs, cards for parallel helpers, a status line, and a settings popup.cli-dispatchrbinarHolds a commandHands a task to DeepSeek, Gemini, Codex, OpenCode, or Copilot, and draws this session's workers above the prompt.pinboardsirkitreeDraws open decisions, the session's todos, and links Claude creates in a side pane so they stay in view.kit-updatesVedantAndhaleToasts when a mod from claude-pro-kit is behind, and by default installs those updates at the start of each session.peekVedantAndhaleOpens a pane of background shells and subagents, with elapsed time and their last output lines.workflow-conductorbruwHolds a commandDraws a board where you plan an agent workflow, sends that plan to Claude when you press r, and shows the run's progress and token cost.godot-stagehandmrfFor Godot Stagehand, which drives a running Godot game, draws the connection and the last frame Claude captured.flowstatepicatzHolds a commandFor Flowstate, a workflow language, draws a pane of runs, checks a Flowfile after an edit, and asks before a flow command that changes a server.
All 396 in Workflow