CLACOROO
EN IT
Download

CLAUDE.md editor

CLAUDE.md is a plain Markdown file Claude Code loads into the conversation context to teach the assistant about your preferences, conventions and constraints. You can have a global one (~/.claude/CLAUDE.md) that applies to every session, and per-project ones (<project>/CLAUDE.md) that apply only inside a folder.

CLACOROO lets you edit both kinds inline from the Settings page, without leaving the app.

Overview

The CLAUDE.md rows in Settings show:

  • Global CLAUDE.md — ~/.claude/CLAUDE.md, applies to every Claude Code session
  • Project CLAUDE.md — one row per project folder you’ve added to CLACOROO; each row shows the project name and the file’s path

Each row has an Edit button that opens an inline editor modal. The modal has a textarea pre-filled with the current file content, Save and Cancel buttons, and the file’s full path at the top for clarity.

What it shows

Allowed paths

For safety, the editor only opens files that match a known whitelist of paths:

  • ~/.claude/CLAUDE.md (global)
  • <project-root>/CLAUDE.md for projects CLACOROO knows about

Attempting to open any other path is refused with a clear error. This prevents an accidental misclick from opening arbitrary files.

Editor behavior

  • Read on open: CLACOROO reads the file from disk every time you click Edit, so you’re always editing the current version
  • Write atomically on Save: temporary file + rename, so the file is never half-written if the app crashes mid-write
  • Cancel discards your in-memory edits and closes the modal without touching disk
  • The modal does not lock anything: if the file changes on disk while you’re editing, the next save will overwrite it. Refresh first if you suspect a conflict.

Plain Markdown, no preview

The editor is a plain textarea — no live preview, no syntax highlighting (the file is Markdown, but reading it is best done in your real editor). The intent is to make small, targeted changes (add a rule, fix a typo, tweak a one-liner). For deep edits, use Open in VS Code from the same row.

Common tasks

How to edit the global CLAUDE.md

  1. Open Settings in CLACOROO
  2. Find the Global CLAUDE.md row
  3. Click Edit
  4. Make changes in the textarea
  5. Click Save — CLACOROO writes the file atomically
  6. Open a Claude Code session: the new content takes effect from the next message

How to edit a project’s CLAUDE.md

  1. Add the project to CLACOROO with + Project in the topbar
  2. Go to Settings → CLAUDE.md section
  3. Find the row for that project
  4. Click Edit and make changes
  5. Save — Claude Code will load the new content the next time it opens a session in that folder

How to discard changes

While in the editor modal, click Cancel (or press Esc). Your in-memory edits are dropped and the file on disk is untouched.

How to edit a CLAUDE.md not on the whitelist

If you want to edit a file in a folder CLACOROO doesn’t yet know about:

  1. Add the folder as a Project (+ Project in the topbar)
  2. Its CLAUDE.md (if any) now appears in the Settings list
  3. Use the inline editor as above

Or, simply open the file in your editor of choice — CLACOROO doesn’t track that file, but Claude Code reads it just the same.

Tips & shortcuts

  • The textarea supports standard Tab indentation and clipboard shortcuts — nothing fancy, but enough for quick tweaks
  • The path shown at the top of the modal is copy-able — useful when you need to paste it elsewhere
  • The Settings row description tells you whether each CLAUDE.md exists or is empty/missing — clicking Edit on a missing one creates it on Save
  • Keep CLAUDE.md short and focused. Long rule-lists end up in the prompt context and cost tokens.

Edge cases & errors

  • “Path not allowed” error. You’re trying to edit a file outside the whitelist (e.g. a CLAUDE.md in a folder CLACOROO doesn’t know about). Add the folder as a Project first.
  • Save failed: permission denied. Your user can’t write the file. Check the file’s owner/permissions in a shell.
  • The editor opens with stale content. Click Cancel and re-open Edit — CLACOROO re-reads the file on every open.
  • My changes don’t take effect in Claude Code. Claude Code reads CLAUDE.md at the start of a session and on key events. Start a new session (or send a fresh message in a long-running one) to be sure.
  • Conflict: the file changed on disk while I was editing. CLACOROO doesn’t detect this; the next Save overwrites. If you suspect a parallel edit, copy your changes elsewhere, click Cancel, re-open Edit, and merge manually.