{"node":{"id":"ff94b18f-43e0-4c83-a456-25cc433dbfd7","handle":"ff94","type":"note","authorName":"Vincent Yeung","intent":"learning","title":"Tool: Astryx for agents (CLI and MCP server)","aiSummary":null,"content":"## What it does\n- A command-line tool and a remote MCP server that let an AI look up Astryx components, templates and props instead of guessing.\n- Astryx says its API, docs and CLI are designed so a person and an AI build the same way.\n\n## When to reach for it\n- An agent is building on Astryx.\n- The agent keeps inventing props or writing raw divs.\n- You're handing the site to someone whose own AI will keep changing it.\n\n## How to use it\n- Always use the scoped name `@astryxdesign/cli`. The bare `astryx` package on npm is unrelated.\n- `npx @astryxdesign/cli init` writes the component list into your AGENTS.md or CLAUDE.md.\n- Lookups: `search`, `docs`, `component <Name>`, `component --list`.\n- The three-step workflow it teaches the agent:\n  1. `build \"<idea>\"` picks a template;\n  2. `template` sets it up;\n  3. `component` reads the props.\n- `template --cdn` writes a no-build HTML page pinned to your installed version.\n- The rules it gives the agent: start every page from a template, no raw divs, no `style={{}}`, tokens instead of made-up values.\n- MCP server: `claude mcp add --transport http astryx https://astryx.atmeta.com/mcp`. It offers `search(query)` and `get(name)`.\n- A global CLI install keeps one Astryx skill at `~/.agents/skills/astryx/SKILL.md`, linked into agent skill folders.\n- `--detail brief` and `--dense` shorten the output for pasting into a chat AI.\n- Add a package.json script alias so agents don't guess the CLI's path.\n- The docs site's llms.txt tells agents to use the CLI instead of crawling pages.\n\n## What happened when we used it\nNot used here yet.\n\n## Source\n- Source: Astryx.","capturedAt":"2026-10-29T09:31:10.412Z","createdAt":"2026-10-29T09:31:10.413Z","updatedAt":"2026-10-29T09:31:10.413Z","spanId":null,"contributor":null,"audiences":[{"kind":"public","createdAt":"2026-11-06T04:27:17.461Z"}],"fingerprint":"52ba88470bbc1372c6f33fff25d588124335bc2775fe4cde42e7e883e8d76896","revisionNo":"1","structureHash":"fca111ae4ffb0caf03fabbc5422e51fd57b197cf8653f02d652a50916226c131","page":"https://lattris.com/by/b/memories/ff94b18f-43e0-4c83-a456-25cc433dbfd7"},"links":[{"direction":"out","verb":"references","reason":"Follow to install it, or to check its licence and cautions before relying on it.","hash":"11b4f1828bc81e2c85d308d2f0700317cd27884c1ddec785af9ab367e47d8e55","node":{"id":"2f2c0edd-25d7-48f1-8130-b1fe4c351f65","handle":"2f2c","type":"note","title":"Source: Astryx","aiSummary":null,"erased":false,"href":"https://lattris.com/api/lattris/by/b/memories/2f2c0edd-25d7-48f1-8130-b1fe4c351f65?links=1","fingerprint":"d761ec49db42fdd14c0969ea58965fac3359b23f1d42679abe0f507d95208719","revisionNo":"2","structureHash":"ee089e894f5fbd9426846cab5da491a0b2750257bd73c23532be7958ca7fa3b9","intent":"learning","authorName":"Vincent Yeung","page":"https://lattris.com/by/b/memories/2f2c0edd-25d7-48f1-8130-b1fe4c351f65"}},{"direction":"out","verb":"references","reason":"Follow for which form control fits which job.","hash":"05e6fa4ae2cf6edcefe5ebdd751327c56d954414839080273a00a8cbf9c538ed","node":{"id":"652bb4cd-0dc8-432d-b2c5-f571a5e308d2","handle":"652b","type":"note","title":"Tool: Astryx forms","aiSummary":null,"erased":false,"href":"https://lattris.com/api/lattris/by/b/memories/652bb4cd-0dc8-432d-b2c5-f571a5e308d2?links=1","fingerprint":"100abb4f344196d894688c0c46799e4f88d89b136b3ee53ff8f205f218929e35","revisionNo":"1","structureHash":"706bfddf88472bf50997bb2c0db60b9a8a8f2d11bc773b3ca071064762bd373e","intent":"learning","authorName":"Vincent Yeung","page":"https://lattris.com/by/b/memories/652bb4cd-0dc8-432d-b2c5-f571a5e308d2"}},{"direction":"in","verb":"references","reason":"Follow to see how to use this capability.","hash":"a5f08d22d7f840ddef66d642856628425eb185385e3a6d93ee318cf6a20271cd","node":{"id":"2f2c0edd-25d7-48f1-8130-b1fe4c351f65","handle":"2f2c","type":"note","title":"Source: Astryx","aiSummary":null,"erased":false,"href":"https://lattris.com/api/lattris/by/b/memories/2f2c0edd-25d7-48f1-8130-b1fe4c351f65?links=1","fingerprint":"d761ec49db42fdd14c0969ea58965fac3359b23f1d42679abe0f507d95208719","revisionNo":"2","structureHash":"ee089e894f5fbd9426846cab5da491a0b2750257bd73c23532be7958ca7fa3b9","intent":"learning","authorName":"Vincent Yeung","page":"https://lattris.com/by/b/memories/2f2c0edd-25d7-48f1-8130-b1fe4c351f65"}},{"direction":"in","verb":"references","reason":"Pick it when an agent builds on Astryx and must look things up instead of guessing.","hash":"483074ce6addd3b155d479bdd10deb8551fb46eb10215b92ac014323824473f1","node":{"id":"98841826-13b8-4843-ba74-fd26981525db","handle":"9884","type":"note","title":"Drawer 5: Building it","aiSummary":null,"erased":false,"href":"https://lattris.com/api/lattris/by/b/memories/98841826-13b8-4843-ba74-fd26981525db?links=1","fingerprint":"5ed8da87f333ea517c55f8b050ca46d893bb1b907cb1151fa7feef68cc0cccdf","revisionNo":"3","structureHash":"f4b3deab8497b5b9ae3a7026a8ae25e2d882e23aeece6ec80513f14acd2b4221","intent":"learning","authorName":"Vincent Yeung","page":"https://lattris.com/by/b/memories/98841826-13b8-4843-ba74-fd26981525db"}},{"direction":"in","verb":"references","reason":"Pick it when the site is built on Astryx and the next person's AI must keep using it correctly.","hash":"9f4d9ef747d5d315db32534edae8d8672bd4304589d86691505e63b1655ae9d3","node":{"id":"c89881f9-196f-47e1-98ed-d75a4571258d","handle":"c898","type":"note","title":"Drawer 7: Shipping","aiSummary":null,"erased":false,"href":"https://lattris.com/api/lattris/by/b/memories/c89881f9-196f-47e1-98ed-d75a4571258d?links=1","fingerprint":"84a05c0f98df15e746ff5d66c0d77e2eda6e2b5fdafc026907c323e7bf6b9777","revisionNo":"1","structureHash":"cc128b64ee43e01d855adc5862ee568da80d0e14712743a7e5c1cbf4594437fc","intent":"learning","authorName":"Vincent Yeung","page":"https://lattris.com/by/b/memories/c89881f9-196f-47e1-98ed-d75a4571258d"}}],"dictionary":{"lattris":"A personal knowledge base — how a person captures what they know as linked blocks they own and control. To understand how this knowledge base works: https://lattris.com/by/4/memories/lattris-a-memory-store-for-your-life-43ff","intents":"Every block can carry an intent — a label for how far you have taken the idea. The scale runs from noticing something to acting on it: noticed (something caught your attention), learning (you are working it out), truth (you are saying this is how things are), decision (you chose a course), action (you did it). Recipe sits outside that scale — it is not a stronger claim, it is a different kind of thing: a procedure, a how-to, a set of steps that ties other knowledge together. Intent is optional — leaving it blank just means you have not labelled it yet."},"instructions_to_ai":"This is knowledge from a personal knowledge base. Read it and consider how it's relevant to what the person you're talking to needs. Follow the linked blocks to explore further related topics if it might be useful to the user; open each at its page address. Start by letting the user know what this is about and how it may be relevant to them."}