The library and files

The Library is the left panel in the Documents tool. It lists every markdown file in your workspace, grouped by type. Toggle it with ⌘B or the panel button in the top bar.

Doc types

Each doc has a type taken from its YAML frontmatter type: field, or guessed from the filename when absent. The six built-in types are:

Type	Colour	Intended for
Rules	Red-orange	Constraints, always-on guidance, `CLAUDE.md`
Plans	Blue	Roadmaps, sprint plans, milestone notes
Arch	Purple	Architecture and system design notes
ADR	Teal	Architecture decision records
Notes	Gray	Everything else
Responses	Indigo	Captured LLM run outputs

You can change a doc’s type from the frontmatter strip above the editor — the type dropdown writes the change back into the file’s frontmatter immediately.

Pinned docs

Pin the docs you reach for most so they stay at the top of the Library:

Hover a doc row and click the … button.
Choose Pin.

Pinned docs appear in a separate Pinned section at the very top, regardless of type. Pinning writes pinned: true into the doc’s frontmatter. Unpin via the same menu.

Hover any doc row and click … to see per-file actions:

Action	What it does
Rename…	Move the file to a new name or subfolder
Duplicate	Make a copy (named `original copy.md`)
Pin / Unpin	Toggle pinned state (persists in frontmatter)
Delete…	Send to the basket with a confirmation prompt

Creating files

Three ways:

Press ⌘N anywhere in the app.
Click New file in the Library footer.
Run New file… from the command palette (⌘K).

All three open the new-file dialog: pick a template, enter a name, press Enter. The file opens immediately in the editor.

Example: creating a constraints file for Claude

Press ⌘N.
Choose the Rules template — it provides type: rules frontmatter and headings like # Constraints, ## Always do, ## Never do.
Name it CLAUDE.md and press Enter.
Fill in your rules. Press ⌘S to save.

Folder management

Organise docs into subfolders:

Create a folder — right-click in the Library or use the New folder button in the Library footer.
Move a file — use Rename… from the … menu and type a path like adr/0001-choose-db.md. The folder is created automatically.
Drag and drop — drag a file row onto a folder row to move it.

The basket (trash)

Deleted docs go to the Basket rather than being permanently removed. Open it from the Library footer (trash icon):

Restore — recover a deleted doc to its original location.
Delete permanently — removes the file for good (with a confirmation).
Empty basket — permanently deletes everything in it at once.

Live sync

Bedrock watches the folder. If you add, edit, rename, or remove files outside the app (in your editor, terminal, or via git), the Library updates automatically — usually within one second. Your unsaved edits are never overwritten by an external change.