{"slug":"records","title":"records","summary":"Introspecting THIS Cerb install's record types with the `cerb records` command line -- aliases, searchable filters, writable fields, and why those last two are separate namespaces. Load it before naming any field or filter.","platform":"Claude","tags":[],"authorName":"LLM Mart","authorSlug":"llm-mart","score":0,"source":"github","price":null,"verified":false,"createdAt":"2026-10-16T16:27:57.746812Z","repo":{"url":"https://github.com/jstanden/cerb","stars":84,"forks":38,"license":null,"updatedAt":"2026-10-16T15:09:59Z"},"bodyHtml":"<hr>\n<h2>name: records\ndescription: Introspecting THIS Cerb install's record types with the <code>cerb records</code> command line -- aliases, searchable filters, writable fields, and why those last two are separate namespaces. Load it before naming any field or filter.</h2>\n<h1>Record types, filters, and fields</h1>\n<h2>The <code>cerb</code> command line — this install, not the generic baseline</h2>\n<p>Your terminal tool carries more than files: <code>cerb</code> is a command line into THIS Cerb install, so you can confirm a record type's alias and its real keys instead of guessing. Prefer it over the docs for lookups — it's one command, and it reflects this installation, including its custom record types and custom fieldsets. The docs describe the generic baseline: they can omit what someone is actually looking at, and list types a plugin here doesn't provide.</p>\n<p><code>cerb records &lt;sub&gt; help</code> prints usage; rows pipe like any command.</p>\n<ul>\n<li><code>cerb records types [--filter &lt;text&gt;]</code> — every record type, with the <code>alias</code> that <code>record.*</code>, a data query's <code>of:</code>, and <code>links.&lt;alias&gt;:</code> all take. <code>cerb records types --filter task</code> → <code>task</code>, <code>task_project</code>.</li>\n<li><code>cerb records filters &lt;type&gt;[,&lt;type&gt;...]</code> — <strong>the keys you can SEARCH by.</strong> <code>cerb records filters ticket</code> returns a <code>key</code>/<code>type</code> table: <code>subject</code> Text, <code>importance</code> Number, <code>created</code> Date, <code>owner.id</code> Worker, <code>group.id</code> Record, <code>status</code> Virtual, <code>messages.count.in</code> Number, <code>spam.score</code> Decimal, <code>links.&lt;record-type&gt;</code> Record, plus this install's custom fieldset keys (e.g. <code>testFieldset.date</code>).</li>\n<li><code>cerb records fields &lt;type&gt;[,&lt;type&gt;...]</code> — the keys you can WRITE, i.e. what <code>record.create</code>/<code>record.update</code> accept, with a required marker and notes. These are NOT query filters; reach for it when someone asks what a field is called on the record itself.</li>\n</ul>\n<h2>Filters and fields are separate namespaces</h2>\n<p><strong>Never lift a key from <code>fields</code> into a query.</strong> On <code>task</code> the writable field is <code>owner_id</code> but the search filter is <code>owner.id</code>; writable <code>status_id</code> takes <code>0</code>/<code>1</code>/<code>2</code> while the <code>status</code> filter takes <code>open</code>/<code>waiting</code>/<code>closed</code>.</p>\n<h2>The <code>type:</code> column tells you which syntax applies</h2>\n<p>Text, Number, Decimal, Date, Seconds, Yes/No, Geo, Worker, Record (a chooser — numeric ids), Search (deep search), Virtual (its own vocabulary, e.g. <code>status:open</code>, <code>watchers:me</code>). The <code>search-queries</code> skill has one expression form per type.</p>\n<h2>Pipe rather than eyeball a long table</h2>\n<pre><code>cerb records filters ticket | filters|filter(r =&gt; r.type == \"Date\")|column(\"key\")\ncerb records types | types|filter(r =&gt; r.is_custom)|column(\"alias\")\n</code></pre>\n<h2>Docs as fallback</h2>\n<p><code>cerb records</code> is the authority for keys. Fall back to <code>cerb-docs</code> for the things it doesn't cover — background and semantics — and cite what you relied on:</p>\n<ul>\n<li><code>/cerb-docs/references/docs/records/types.md</code> — the baseline record type list (the index), plus <code>types/&lt;type&gt;.md</code> for one type's background (e.g. <code>types/ticket.md</code>). Each type page lists its Records API fields, dictionary placeholders, Search Query Fields, and worklist columns.</li>\n<li><code>/cerb-docs/references/docs/records/fields/types/</code> — what a field TYPE means: <code>text</code>, <code>number</code>, <code>float</code>, <code>timestamp</code>, <code>boolean</code>, <code>context</code>, <code>links</code>, <code>url</code>, <code>object</code>, <code>image</code>, <code>extension</code>.</li>\n</ul>\n","files":[{"path":"SKILL.md","sizeBytes":3202,"isText":true}],"reviewScore":null,"reviewSummary":null,"trust":{"provenance":"trusted-source-unreviewed","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow.","bodySource":null},"bodyLocked":false,"purchaseUrl":null,"sourceUrl":null,"report":{"provenance":"trusted-source-unreviewed","screen":{"ran":true,"outcome":"clean","suspicious":0,"notes":0,"hiddenCharacters":false},"virusScan":{"engine":"clamav","status":"clean","scannedAt":"2026-10-16T16:28:16.27586Z","sha256":"D165602E57E75D07677CEA356C919CC23E21C18F9DFC2A45A7D1CE21EFB21CAF","sizeBytes":1622},"review":null,"source":{"repositoryUrl":"https://github.com/jstanden/cerb","path":"features/cerberusweb.core/assets/agent_filesystems/cerb-agents/skills/records","license":null,"commit":"cf28b62ee0f67ff993645931568a4e4bbad074f0","subtreeSha":"038FB3899B2C6CD212155958AB742223DA06815E3A23E164E49B9946FA9DF4D5","lastSyncedAt":"2026-10-16T16:27:56.786317Z"},"reviewedAt":"2026-10-16T16:28:43.30743Z","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow."},"install":[{"target":"skills-cli","command":"npx skills add https://github.com/jstanden/cerb/tree/12.0.x/features/cerberusweb.core/assets/agent_filesystems/cerb-agents/skills/records"},{"target":"claude-code","command":"claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install jstanden-cerb@llmmart"},{"target":"git","command":"git clone https://github.com/jstanden/cerb.git"}]}