Read a doc
getA doc's file: the current one, or a History entry. Returns its details, then the file's text. A file over 20,000 characters comes back as its outline (headings with line numbers) instead: read the part you need with "lines", or all of it with "full". A sheet comes back as its outline: each sheet's columns, what's in them, and the version to change it at; read gives its rows. Slides come back as their outline and version. "slides": ["s3"] gives those slides as HTML with box IDs, to edit or to rewrite with slide.html. "kit": true gives the theme's classes, the allowed styles and example slides (once is enough); with no doc, for "theme" (default Harbor). "asks": true lists what people asked the AI to do. A board comes back as its table of contents and version. "frames": ["f2"] gives those frames' items, one line each by short ID; "items": ["s12"] gives items whole; "since": N what changed after version N; "positions": true adds @x,y w×h (in the frame's units); "asks": true lists what people asked the AI to do. Word docs: the outline (title, version, pages, words, headings with IDs, pages and word counts, open suggestions and asks, the AI changes setting; about 2 KB for 200 pages). Then read only what you need: "blocks": ["h3"] (a heading and its section, or any block), "from": "p40" (on from a block), "pages": "4-6", "find": ["fees", "termination"] (blocks with IDs, page and a snippet), several at once; "since": N what changed after a version; "suggestions": true the open ones; "asks": true what people asked. Lines start with the block's ID; suggestions show as {++added++}[sg3] and {--deleted--}[sg3]. OpenAPI: the overview and version; "find" a task, then "ops", "schemas", "types" or "call"; "since" what changed. A database design: the DBML up to 80 tables, else the outline; "db" picks a read, "since" what changed after a version, "positions" each table's place. With "comments" or a comment link: the doc's threads, each with its ID, open or resolved, where it sits, and its comments. With "approvals": the doc's version now, the open request, its approvers' answers and the requests before it.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| db | No | A database design. No option: the DBML up to 80 tables, else the outline: a line a table with its keys, links (→ table) and column count, by group. Then read only what's needed: {"outline":true} · {"tables":["orders"],"hops":1} (in full as DBML, the tables 1 to 3 refs away as outline lines) · {"find":"invoice"} (names first, then types, settings and notes; "type:uuid", "set:cascade", "note:lender" look in one place) · {"refs_to":"users.id"} (every ref, index, group, view and dep naming it) · {"impact":"orders.coupon_id"} (what a drop or type change breaks: the columns to change too, what a drop takes, where deleting a row cascades, lineage downstream) · {"path":["payments","users"]} (the shortest joins, as SQL) · {"since":12} (only what changed since version 12). A long answer ends "…and N more" with the read that gives the rest. | |
| doc | No | The doc's link or its code. | |
| kit | No | Slides only. The theme's classes, styles and example slides. With no doc: for "theme" and "density". Once a session is enough. | |
| ops | No | OpenAPI: operationIds or "POST /v1/refunds". | |
| asks | No | Slides, boards and Word docs. What people asked the AI to do: open and taken asks. | |
| call | No | OpenAPI: "PostRefunds" or {"op", "lang": "curl"|"fetch"|"python"}. | |
| find | No | OpenAPI: a task in words, "refund a payment". Word docs: words to find, "fees" or ["fees", "termination"]: blocks with IDs, page and a snippet. | |
| from | No | Word docs: read on from this block, "p40", as far as 8,000 words. | |
| full | No | The whole file, however long. OpenAPI: "yes" past the warning. | |
| page | No | ||
| text | No | HTML as readable text: no tags, scripts or styles, headings and list items kept as # and -. Often a few times shorter, for reading: edit_doc matches the HTML source. Markdown is already text. Slides: the outline. | |
| depth | No | OpenAPI: ref levels expanded. | |
| entry | No | A History entry number. Default: current. | |
| group | No | OpenAPI: a group's operations. | |
| items | No | Boards only. These items whole, untrimmed: ["s12", "k3"] (50 at most). | |
| lines | No | Only these lines of the file: "120-260", "120-" (to the end) or "120". | |
| pages | No | Word docs: pages, "4" or "4-6". | |
| since | No | Slides, boards and Word docs: the version you read last. Slides: the outline marks who else edited which slide after it. Boards and Word docs: only what changed after it. | |
| theme | No | With "kit" and no doc: the theme, Harbor, Harbor Dark, Paper, Slate (default Harbor). | |
| types | No | OpenAPI: ["PostRefunds"] or {"ops", "lang": "ts"|"zod"|"pydantic"}. | |
| blocks | No | Word docs: blocks by ID, ["h3", "p14"]; a heading gives its section. | |
| export | No | OpenAPI: a download link to the file as this. | |
| frames | No | Boards only. These frames' items, one line each by short ID, in reading order: ["f2"] (IDs or names, 10 at most). | |
| slides | No | Slides only. These slides as HTML with data-box IDs: ["s3"] (IDs or names). | |
| comment | No | A thread's ID (cth_…): only that thread. A comment link as "doc" does the same. | |
| density | No | With "kit" and no doc: the density (default comfortable). | |
| outline | No | Only the details and the outline: each heading with the line it starts on. | |
| refs_to | No | OpenAPI: what uses a schema. | |
| schemas | No | OpenAPI: schema names. | |
| breaking | No | OpenAPI: with "since", only what breaks. | |
| comments | No | The doc's comment threads instead of its file: open (default with true), resolved or all. | |
| approvals | No | The doc's approval request and its history instead of its file. | |
| positions | No | Boards only. Adds @x,y w×h to each line, in the frame's units, for placing things yourself. Most changes need none: use "in", "near", arrange and cluster. Database designs: // @x,y after each table, its place on the canvas. | |
| suggestions | No | Word docs: the open suggestions, with IDs, who and what. | |
| descriptions | No | OpenAPI: with descriptions. |