claude-familiar

Claude Familiar

Give your Claude Code companion a personality, mood, backstory, and interactive commands — or build your own companion plugin that stacks with others.

[](https://github.com/yaniv-golan/skill-creator-plus) [](https://github.com/yaniv-golan/mcp-bash-framework) [](https://github.com/yaniv-golan/claude-familiar/actions/workflows/ci.yml) [](https://github.com/yaniv-golan/claude-familiar/blob/main/LICENSE)

What you get

Out of the box, the Claude Code companion reacts with generic messages that can't be customized by plugins. With Claude Familiar installed:

• Personality and traits are injected into every session — the companion responds in character
• Mood shifts automatically as you work (cheerful after successes, grumpy after failures) and decays over time
• Lore accumulates across sessions — add backstory entries that persist
• Interactive commands — ask for fortunes, code roasts, haiku, stats, and more
• Extensible — other plugins can add their own traits, lore, and mood modifiers by declaring "x-familiarExtensions" in their plugin.json. Everything merges automatically.

With the optional binary patch

The companion's speech bubble normally calls Anthropic's reaction API. The patch redirects it to a local server (`familiar-react`) that reads your familiar's state, calls Claude Haiku in-character, and sends the reaction to the bubble. Without the patch, commands like fortune and roast still work — they just appear in Claude's response text instead of the speech bubble.

...