Record room
Find, read, edit, and delete center records, including the boot chunks agents read at startup.
When to use it
Inspect and correct what the team remembers. Decisions, results, and rules become records for agents to use in later work. This structure is explained in Shared memory. Correct a record if an agent remembers incorrectly; edit its boot chunk to change how it works.
Screenshot placeholder 1 · Full record roomFile name
assets/turtlecenter/ui-record-room-1.png · Recommended size: 1600×900Location at top, category buttons left, record list center, content right. Numbered annotations are planned.Layout
- Location row: Shows Record room › Category › Selected cabinet › Selected record.
- Category buttons, left: Chunks(boot chunks), Cabinets(file cabinets), Notes(notes), plus at the bottom ↻(refresh all).
- Record list, center: Select a cabinet or agent above, then a record in the table below.
- Record content, right: Title, body, and tags for the selected record. Drag the divider to resize the list.
- Status row: Briefly shows outcomes such as saving or deletion.
Screenshot placeholder 2 · Categories and list controlsFile name
assets/turtlecenter/ui-record-room-2.png · Recommended size: 1600×900Category buttons (Chunks, Cabinets, Notes, ↻), selector, buttons, and table headings.Three categories
| Button | Name | Contains | Choose above |
|---|---|---|---|
| Chunks | Boot chunks | Startup records, with one chunk cabinet per agent. | Agent (agent chunk cabinet) |
| Cabinets | File cabinets | Topic-based drawers containing records | File cabinets |
| Notes | Notes | Several notes grouped under a topic. | Note topic |
Record-list columns
Chunks and Cabinets share columns; two columns differ for Notes. Drag a heading boundary to resize a column. Widths are remembered on this computer.
| Column | Chunks · Cabinets | Notes |
|---|---|---|
| Checkbox | Chunks: unavailable / Cabinets: select multiple records | Select multiple notes |
| ID | Record number | Record number |
| TITLE | Title | Title |
| TYPE | Record type | Record type |
| Author | Person or agent who created it | Same |
| Created at | Creation time | Same |
| STATUS / REVIEW | STATUS: Record state | REVIEW: Whether review is needed |
| IS_BOOT / TOPIC | IS_BOOT: TRUE for startup records | TOPIC: Parent note topic number |
Controls at a glance
| Position | Name | Action | Categories |
|---|---|---|---|
| Above the list | Agent / File cabinet / Note topic selector | Choose which agent cabinet, cabinet, or note topic to view. Unsaved edits trigger a prompt before switching. | Chunks · Cabinets · Notes |
| Above the list | Author and creation time | Shows who created the selected cabinet or topic and when. Notes also show Category 1, Category 2, and topic tags. | Chunks · Cabinets · Notes |
| Above the list | ○ records | Number of records in the current list. | Chunks · Cabinets · Notes |
| Above the list | New chunk / New cabinet / New note | Opens a creation dialog for the category. | Chunks · Cabinets · Notes |
| Above the list | Rename cabinet | Edit the selected cabinet's title, description, and tags. | Cabinets |
| Above the list | New record | Creates a record inside the selected cabinet. | Cabinets |
| Above the list | Delete selected records | Deletes checked records together. The button shows the selected count. | Cabinets · Notes |
| Above the list | ⌕ (search) | Toggles the Title/tag search field. Searches titles, tags, status, and body. | Chunks · Cabinets |
| Above content | Edit | Enters edit mode for the selected record. | Chunks · Cabinets · Notes |
| Above content | Save | Applies edits; visible only in edit mode. | Chunks · Cabinets · Notes |
| Above content | Cancel | Discards editing and returns to the original; visible only in edit mode. | Chunks · Cabinets · Notes |
| Above content | Delete | Deletes the selected record. | Chunks · Cabinets · Notes |
| Above content | Refresh | Reloads the selected record. | Chunks · Cabinets · Notes |
Edit fields
| Field | Description | Category |
|---|---|---|
| Title | Required, up to 800 characters. | All |
| Body (Markdown source) | Edit raw Markdown. Reading view renders it for display. | All |
| Tags | Comma-separated, up to 1,000 characters. | Chunks · Cabinets |
| Status | Record state text, up to 80 characters. | Cabinets |
| is_boot record used for OFF boot | Marks the record for reading at agent startup. | Chunks · Cabinets |
| Review needed | Check notes that a person should review again. | Notes |
Creation uses the same fields. For a new cabinet, Body becomes Description.
Screenshot placeholder 3 · Record editorFile name
assets/turtlecenter/ui-record-room-3.png · Recommended size: 1600×900Right-hand editor with title, body, tags, status, is_boot, Save, and Cancel.States and messages
| Display | Meaning | Action |
|---|---|---|
| Select an agent. | No agent selected in Chunks. | Choose an agent above. |
| This chunk cabinet has no is_boot record. | The selected agent has no boot record. | Use New chunk to create one. |
| This cabinet has no records. / This note topic has no notes. | The selected cabinet or topic is empty. | Add a record or select another cabinet. |
| No search results. | No records match. | Use fewer words or search by tag. |
| Select a chunk cabinet first. / Select a cabinet first. / Select a note topic first. | No destination selected for the new record. | Choose one above first. |
| Title cannot be empty. | You tried saving without a title. | Enter a title, then save. |
| No changes · Markdown source preserved | Nothing changed, so no save was made. | No action needed. |
| Saved / Created / Renamed / Deleted | The request was applied. | Refresh to check if needed. |
| Save or cancel editing first. | You tried another action while editing. | Click Save or Cancel first. |
| Bridge connection required / Unable to load records. | The connection for reading records is not ready. | Use ↻ Refresh all; if it persists, open the Control viewto check connectivity. |
| Discard edits? | You tried switching records with unsaved changes. | Choose Continue editing, Save, or Discard changes. |
Workflows
Read or edit an agent's boot chunk
- On the left, click Chunks.
- Choose an agent above. Only its boot records are listed.
- Select a record to read it.
- To change it, click Editthen edit the body and Save. Saved confirms the change was applied.
Boot chunks affect behavior. Copy the original body before editing. To apply a change to a working agent, wait until its task ends, then Reset. To be confirmed Whether boot edits apply at next startup or are immediately reread on reset requires another check.
Find and delete several records
- Cabinetsand choose a cabinet.
- Open ⌕ and enter a query in Title/tag search.
- Check records to delete. The header checkbox selects all visible records.
- Delete selected records (N)and approve the confirmation.
Leave a note
- Notesand choose a note topic.
- New noteto enter title and body; check Review needed if appropriate, then click Create.
Things to know
- Deletion asks for confirmation, but this screen has no Undo. Single deletion asks Delete this record? Bulk deletion asks Delete N selected records? This cannot be undone. To be confirmed Whether deletion removes server data permanently or marks it deleted is still being checked.
- Bulk deletion is available only in Cabinets and Notes. Chunks has disabled selection boxes, so delete one at a time.
- Switching records or categories during editing asks Discard edits? Read the choices to avoid accidental loss.
- Column widths are saved on this PC, not other centers' computers.
- Incorrect manual edits may give agents incorrect memory. Copy important content before changing it.
- To save a meeting as a record, see the Meeting roomSave (.md) function.
Related screens
Agent roomReset rereads agent boot chunks. For unstable connections, see Control view; to check delivery, see the Communication monitor.