whatisgithub

What is brainstormer?

fyne4247/brainstormer — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · writerComplexity · 2/5Setup · easy

In one sentence

A Claude Code workspace built for creative writers, where AI agents brainstorm, critique, and check continuity but never write the actual prose.

Mindmap

mindmap
  root((brainstormer))
    What it does
      Editorial partner not ghostwriter
      Multi project workspace
      Shared agents and skills
    Tech stack
      Claude Code
      Python scripts
      Git hooks
    Use cases
      Brainstorm story ideas
      Critique your own prose
      Check continuity and canon
      Simulate reader reactions
    Audience
      Fiction writers
      Creative writing hobbyists
    Setup
      Install Claude Code
      Run launcher script
      Optional Python for exports

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Brainstorm plot ideas and get structured feedback on your own manuscript pages.

USE CASE 2

Keep a knowledge base of characters and story facts that an AI agent checks for continuity.

USE CASE 3

Run a simulated book club to see how different reader personas react to a chapter.

USE CASE 4

Organize multiple independent writing projects with their own conventions in one workspace.

What is it built with?

PythonClaude CodeShellGit hooks

How does it compare?

fyne4247/brainstormer0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultyeasymoderatemoderate
Complexity2/52/54/5
Audiencewritergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 30min

Requires Claude Code installed, Python is optional and only needed for automatic project export snapshots.

No license information is stated in the README.

So what is it?

This project is a personal creative writing workspace built around Claude Code, the AI coding assistant, but repurposed here for fiction and other prose writing rather than software. It holds several independent writing projects, each in its own subfolder with its own knowledge base and its own set of conventions, and they all share a common set of specialized helper agents and skills. The central rule of the whole setup is that Claude never writes the actual prose. The author writes every word of the manuscript themselves. Claude's role is limited to being an editorial partner: brainstorming ideas, critiquing the author's own pages, checking that characters and story details stay consistent, outlining structure, building style notes from existing writing, and keeping the knowledge base organized. You start a session using a lead agent called muse, which coordinates several focused helper agents such as a critic, an editor, a reader simulator, a continuity checker, a brainstormer, an outliner, a style creator, a character simulator, and a chronicler. Muse can also run something called a book club, where four different reader personas react to a piece of writing so the author can see how different kinds of readers might respond to it. To make this easier to use day to day, the project includes a double clickable launcher file that starts a muse session without needing to open a terminal manually. Before Claude starts, this launcher walks you through simple menus to pick a model, an effort level, and which project to work on, and when the session ends it checks for unsaved changes in every project folder and offers to save them automatically. Setting it up mostly means installing Claude Code itself, making the launcher file executable, and optionally installing Python so that project snapshots can be automatically regenerated after each save through a git hook. New projects created inside the workspace set this up for themselves automatically. Overall this is a structured way for a writer to use an AI assistant as a thinking and editing partner while keeping full ownership of the writing itself.

Copy-paste prompts

Prompt 1
Start a muse session on my writing project and have the critic agent review the latest chapter I wrote.
Prompt 2
Run the continuity checker against my project's knowledge base and flag any contradictions.
Prompt 3
Use the book club feature on this scene and tell me how the four reader personas responded.
Prompt 4
Set up a new writing project in this workspace using the /setup interview process.

Frequently asked questions

What is brainstormer?

A Claude Code workspace built for creative writers, where AI agents brainstorm, critique, and check continuity but never write the actual prose.

What language is brainstormer written in?

Mainly Python. The stack also includes Python, Claude Code, Shell.

What license does brainstormer use?

No license information is stated in the README.

How hard is brainstormer to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is brainstormer for?

Mainly writer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.