From nothing to your first card

What you need

Claude Code, not the Claude chat

Clipped is a Claude Code plugin. It works in the Code tab of the Claude desktop app, in the claude command in a terminal, and in the VS Code and JetBrains extensions.

It does not work in the regular Claude chat (the Chat tab, or claude.ai in a browser). The board is a file inside your project folder, and Claude updates it by running a small command on your computer. Chat can't reach either.

Node 20 or newer

The board command and its hooks are small Node scripts. To check, open a terminal and run:

If it prints v20 or higher, you're set. If it says command not found or an older version, install the LTS version from nodejs.org, then close and reopen Claude.

Without Node the plugin still installs, but the board never updates, and nothing tells you why.

Install the plugin

Pick whichever is easiest. All three end in the same place.

Restart

Plugins load when Claude starts, so a session that was already open doesn't have it yet.

• Desktop app: quit it fully (⌘Q on a Mac, not just closing the window) and open it again. Starting a new session alone can leave the slash-command list out of date.
• Terminal or editor: exit claude and run it again, or type /reload-plugins.

To check it loaded, start a session and type / in the message box. You should see clipped:board, clipped:park, clipped:done, clipped:question and clipped:plan.

Work as usual

Open a session in your project folder and talk to Claude the way you already do. There's no setup command.

The first time something is worth keeping — a feature you start building, a question answered with a comparison or a table, a "let's do that later" — Claude records it, and the project's board appears in a .board/ folder at the top of the project. Short questions and one-line answers stay off the board on purpose.

Want the board to start from what you've already done? Say:

Your home folder and hidden folders never get a board. If you work from one of those, open the project folder instead.

Open the board

The board opens in your browser at clipped.localhost:4747 (localhost:4747 works too). Saying "open the board" to Claude does the same. The first time, a welcome page lists your projects and fills in live as Claude records the first task. The sidebar lists every project on this computer that has a board, and each project has tabs for Work, Questions, Brainstorms, Plans, Design, References and Outputs. Keep the tab open: it updates live while Claude works, and new projects appear on their own.

/clipped:board status prints the same summary in the chat instead.

Check it works

In a new session in your project, with the board open next to it, send these one at a time:

All five showed up? It works. From here on, just work — you never have to run these commands.

Stop the permission prompts

Claude Code asks before running a command, and Clipped's is called board. You may see Allow Claude to run board …? a few times. It's safe to allow: board only reads and writes .board/board.json in your project and ~/.clipped/.

To stop being asked in every project, add this to ~/.claude/settings.json (create the file if it isn't there):

{
  "permissions": {
    "allow": ["Bash(board *)"]
  }
}

If the file already has a permissions.allow list, add "Bash(board *)" to it instead of pasting a second one.

Update or remove

Update

Clipped doesn't update itself. When there's a new version:

• Desktop app: + → Plugins → Manage plugins → Clipped → update, then start a new session.
• Terminal or editor: /plugin → Installed → Clipped → Update now, then /reload-plugins.

The shell version of the same thing.

Remove

• Desktop app: + → Plugins → Manage plugins → Clipped → uninstall.
• Anywhere else:

Your boards stay behind. To remove them too, delete .board/ in your projects and ~/.clipped/. Nothing else is left.

Stuck on something this page doesn't cover? Open an issue with a screenshot.