[{"data":1,"prerenderedAt":1565},["ShallowReactive",2],{"guide-second-brain-for-ai-agents":3},{"id":4,"title":5,"authorKey":6,"body":7,"breadcrumb":1510,"cta":1511,"description":1515,"draft":1516,"extension":1517,"eyebrow":1510,"faq":1518,"icon":1549,"iconColor":1550,"items":1551,"meta":1552,"navigation":945,"parent":1553,"path":1556,"published":1557,"readingTime":1558,"seo":1559,"stem":1562,"updated":1563,"__hash__":1564},"guides\u002Fguides\u002Fsecond-brain-for-ai-agents.md","How to build an AI second brain that you and your agents share","steffen",{"type":8,"value":9,"toc":1487},"minimark",[10,14,17,26,34,46,51,109,113,116,131,137,140,144,150,155,168,173,176,205,208,212,215,220,252,257,289,293,300,305,343,350,355,362,489,492,514,518,522,525,536,539,542,545,587,591,594,597,603,609,615,621,626,629,648,655,659,699,703,711,714,718,750,754,761,764,797,800,803,817,819,821,825,841,845,859,908,911,915,1377,1381,1387,1390,1416,1420,1483],[11,12,13],"p",{},"Agents are only as good as what they know about your work. In 2025, Shopify's Tobi Lütke called this \"the art of providing all the context for the task to be plausibly solvable by the LLM\", and Andrej Karpathy called it \"filling the context window with just the right information for the next step.\" The name stuck: context engineering.",[11,15,16],{},"Most of that context is not code. It is why you chose one approach over another, what the customer said on Tuesday, who owns what, what you read last month, and what you already tried. If it lives only in your head, every agent starts from zero. If it lives in one agent's memory, you lose it when you switch tools.",[11,18,19,20,25],{},"So people are building AI second brains: one knowledge base that they and their agents share. This guide compares the two ways to do that, a folder of Markdown files and a notes app your agents connect to, and shows how to set up the second one. We make ",[21,22,24],"a",{"href":23},"\u002F","Capacities",", which is the second kind. We say plainly when the first kind is the better choice.",[11,27,28,29,33],{},"It also argues for one habit that matters more than the tool: let agents write back in ",[30,31,32],"strong",{},"atomic notes",", one idea per note, with a title that states the idea.",[35,36,38],"tip",{"title":37},"A skill to copy at the end",[11,39,40,41,45],{},"The guide ends with a ",[21,42,44],{"href":43},"#the-skill-save-a-conversation-as-an-atomic-note","free skill"," for Claude, ChatGPT, Claude Code, Cursor, and Codex. Say \"save this as an atomic note\", and your assistant turns the essence of the conversation into one note in Capacities. It uses only tags you already have, and it links the note to the book, podcast, or article the idea came from.",[47,48,50],"h2",{"id":49},"the-short-answer","The short answer",[52,53,54,67],"table",{},[55,56,57],"thead",{},[58,59,60,64],"tr",{},[61,62,63],"th",{},"If you want…",[61,65,66],{},"Use",[68,69,70,85,93,101],"tbody",{},[58,71,72,76],{},[73,74,75],"td",{},"Agents that grep, rewrite, and refactor your notes as files, under Git",[73,77,78,79],{},"A Markdown vault, for example ",[21,80,84],{"href":81,"rel":82},"https:\u002F\u002Fobsidian.md",[83],"nofollow","Obsidian",[58,86,87,90],{},[73,88,89],{},"Notes you also use on your phone, reachable from ChatGPT, Claude, and Cursor alike",[73,91,92],{},"A connected notes app, such as Capacities",[58,94,95,98],{},[73,96,97],{},"A shared knowledge base for a team, with permissions",[73,99,100],{},"A team wiki with an AI connector, such as Notion",[58,102,103,106],{},[73,104,105],{},"Memory of facts and preferences, with no notes you read yourself",[73,107,108],{},"A memory service such as Supermemory, or built-in memory",[47,110,112],{"id":111},"two-kinds-of-context","Two kinds of context",[11,114,115],{},"It helps to split what an agent needs into two kinds.",[11,117,118,121,122,126,127,130],{},[30,119,120],{},"Instructions for one project."," How to build, test, and name things. Which libraries to use. This belongs in the repository, next to the code: ",[123,124,125],"code",{},"CLAUDE.md",", ",[123,128,129],{},"AGENTS.md",", or Cursor's rules. Claude Code's docs call this \"how Claude remembers your project\", and it works well.",[11,132,133,136],{},[30,134,135],{},"Knowledge that spans projects."," People, decisions, meetings, research, and things you learned. This does not belong in a project file. It belongs somewhere you also read and write yourself, on any device, and that every agent can reach. Most of it comes in small pieces: one decision, one insight from a book, one thing a customer said.",[11,138,139],{},"The second kind is the AI second brain. The question is where it should live.",[47,141,143],{"id":142},"option-one-a-folder-of-markdown-files","Option one: a folder of Markdown files",[11,145,146,147,149],{},"This is the most popular setup today. You keep an Obsidian vault, start Claude Code in that folder, add a ",[123,148,125],{}," that explains your conventions, and keep everything in Git. Karpathy's \"LLM wiki\" pattern, an agent that maintains a personal wiki of Markdown pages, is a version of this.",[11,151,152],{},[30,153,154],{},"Why people like it",[156,157,158,162,165],"ul",{},[159,160,161],"li",{},"The agent works on files directly. It can search with grep, rewrite fifty notes at once, and move things around.",[159,163,164],{},"Git gives you a full history and a real \"undo all of that\".",[159,166,167],{},"Any tool can read the files, and there is no vendor in between.",[11,169,170],{},[30,171,172],{},"Where it breaks",[11,174,175],{},"People who run this setup describe the same problems:",[156,177,178,184,190,199],{},[159,179,180,183],{},[30,181,182],{},"Knowledge rot."," One r\u002FClaudeAI post: \"a simple Obsidian vault will quickly turn into a mess of outdated facts.\" The agent writes fast, and nobody prunes.",[159,185,186,189],{},[30,187,188],{},"Messy links."," In r\u002FObsidianMD: \"Without a clear rule, Claude would create bidirectional links everywhere.\"",[159,191,192,195,196,198],{},[30,193,194],{},"You maintain the schema."," Types are front matter conventions in a ",[123,197,125],{},". Every agent has to follow them, and you have to keep them current.",[159,200,201,204],{},[30,202,203],{},"It lives on one computer."," Claude Code needs the folder. On your phone, or in ChatGPT, the vault is out of reach unless you set up sync and a separate server.",[11,206,207],{},"If you are a developer who lives in a terminal, this setup is excellent, and we would not talk you out of it.",[47,209,211],{"id":210},"option-two-a-notes-app-your-agents-connect-to","Option two: a notes app your agents connect to",[11,213,214],{},"Here your knowledge lives in a notes app, and agents reach it through a connector. The technical name is MCP, the Model Context Protocol. Claude Code, Cursor, Codex, ChatGPT, Claude, and many other tools support it. Each one gets the same tools: search, read, create, edit.",[11,216,217],{},[30,218,219],{},"Why it works well",[156,221,222,228,234,240,246],{},[159,223,224,227],{},[30,225,226],{},"The schema is built in."," In Capacities, every note has a type, such as Meeting, Person, Decision, or Source, and each type has properties. An agent can ask for a type's properties before it writes, so it fills in the right ones without a convention file.",[159,229,230,233],{},[30,231,232],{},"You use it as a person, not just as a store."," The same notes open on your phone, with a daily note, links in both directions, and search. You read what agents wrote, and you fix it.",[159,235,236,239],{},[30,237,238],{},"Every agent sees the same knowledge."," Claude Code at your desk, ChatGPT on your phone, and Cursor in the editor all read and write the same space.",[159,241,242,245],{},[30,243,244],{},"Undo per note."," Every edit is saved in the note's version history.",[159,247,248,251],{},[30,249,250],{},"Access is scoped."," Each connection reaches one space. Keep work and personal in separate spaces and connect only what an agent needs.",[11,253,254],{},[30,255,256],{},"Where it falls short",[156,258,259,265,271,277,283],{},[159,260,261,264],{},[30,262,263],{},"Tools, not files."," An agent searches and reads through tool calls. It cannot grep the whole space or rewrite hundreds of notes in one pass.",[159,266,267,270],{},[30,268,269],{},"Broad scans are weak."," \"Read everything and find patterns\" works poorly. \"List my Meeting notes from September, then read them\" works well.",[159,272,273,276],{},[30,274,275],{},"Agents cannot change the structure."," They cannot create a new type or add a property. You do that in the app.",[159,278,279,282],{},[30,280,281],{},"There is a creation quota."," Objects created through the connector and the API share a limit of 10,000, which grows by 500 a month after you reach it.",[159,284,285,288],{},[30,286,287],{},"It is a cloud app."," Your notes are stored on EU servers, encrypted in transit and at rest, but not end-to-end encrypted, and not local files. You can export to Markdown at any time.",[47,290,292],{"id":291},"setting-it-up-with-capacities","Setting it up with Capacities",[11,294,295,296,299],{},"You need Capacities Pro. Each agent connects with the same server URL, ",[123,297,298],{},"https:\u002F\u002Fapi.capacities.io\u002Fmcp",", and you sign in once per agent.",[11,301,302],{},[30,303,304],{},"Claude Code",[306,307,312],"pre",{"className":308,"code":309,"language":310,"meta":311,"style":311},"language-bash shiki shiki-themes material-theme-lighter github-light github-dark","claude mcp add --transport http capacities https:\u002F\u002Fapi.capacities.io\u002Fmcp\n","bash","",[123,313,314],{"__ignoreMap":311},[315,316,319,323,327,330,334,337,340],"span",{"class":317,"line":318},"line",1,[315,320,322],{"class":321},"sbgvK","claude",[315,324,326],{"class":325},"s_sjI"," mcp",[315,328,329],{"class":325}," add",[315,331,333],{"class":332},"stzsN"," --transport",[315,335,336],{"class":325}," http",[315,338,339],{"class":325}," capacities",[315,341,342],{"class":325}," https:\u002F\u002Fapi.capacities.io\u002Fmcp\n",[11,344,345,346,349],{},"Then run ",[123,347,348],{},"\u002Fmcp"," in Claude Code and sign in.",[11,351,352],{},[30,353,354],{},"Cursor",[11,356,357,358,361],{},"In ",[123,359,360],{},"Settings → MCP",", add a global server:",[306,363,367],{"className":364,"code":365,"language":366,"meta":311,"style":311},"language-json shiki shiki-themes material-theme-lighter github-light github-dark","{\n  \"mcpServers\": {\n    \"capacities\": {\n      \"url\": \"https:\u002F\u002Fapi.capacities.io\u002Fmcp\",\n      \"auth\": { \"CLIENT_ID\": \"cursor_mcp_capacities_public\" }\n    }\n  }\n}\n","json",[123,368,369,375,395,411,436,471,477,483],{"__ignoreMap":311},[315,370,371],{"class":317,"line":318},[315,372,374],{"class":373},"sP7_E","{\n",[315,376,378,382,386,389,392],{"class":317,"line":377},2,[315,379,381],{"class":380},"s39Yj","  \"",[315,383,385],{"class":384},"sseR_","mcpServers",[315,387,388],{"class":380},"\"",[315,390,391],{"class":373},":",[315,393,394],{"class":373}," {\n",[315,396,398,401,405,407,409],{"class":317,"line":397},3,[315,399,400],{"class":380},"    \"",[315,402,404],{"class":403},"sZMiF","capacities",[315,406,388],{"class":380},[315,408,391],{"class":373},[315,410,394],{"class":373},[315,412,414,417,421,423,425,429,431,433],{"class":317,"line":413},4,[315,415,416],{"class":380},"      \"",[315,418,420],{"class":419},"srdBf","url",[315,422,388],{"class":380},[315,424,391],{"class":373},[315,426,428],{"class":427},"sjJ54"," \"",[315,430,298],{"class":325},[315,432,388],{"class":427},[315,434,435],{"class":373},",\n",[315,437,439,441,444,446,448,451,453,457,459,461,463,466,468],{"class":317,"line":438},5,[315,440,416],{"class":380},[315,442,443],{"class":419},"auth",[315,445,388],{"class":380},[315,447,391],{"class":373},[315,449,450],{"class":373}," {",[315,452,428],{"class":380},[315,454,456],{"class":455},"swQdS","CLIENT_ID",[315,458,388],{"class":380},[315,460,391],{"class":373},[315,462,428],{"class":427},[315,464,465],{"class":325},"cursor_mcp_capacities_public",[315,467,388],{"class":427},[315,469,470],{"class":373}," }\n",[315,472,474],{"class":317,"line":473},6,[315,475,476],{"class":373},"    }\n",[315,478,480],{"class":317,"line":479},7,[315,481,482],{"class":373},"  }\n",[315,484,486],{"class":317,"line":485},8,[315,487,488],{"class":373},"}\n",[11,490,491],{},"Restart Cursor. It asks you to sign in the first time it uses Capacities.",[11,493,494,497,498,503,504,508,509,513],{},[30,495,496],{},"Codex, VS Code, OpenCode, Gemini CLI, and others"," use the same URL. The ",[21,499,502],{"href":500,"rel":501},"https:\u002F\u002Fdocs.capacities.io\u002Freference\u002Fai-chat-connectors",[83],"setup guide"," has the steps for each. ChatGPT and Claude connect from their directories, see ",[21,505,507],{"href":506},"\u002Fconnect-chatgpt-to-your-notes","ChatGPT"," and ",[21,510,512],{"href":511},"\u002Fconnect-claude-to-your-notes","Claude",".",[47,515,517],{"id":516},"what-it-looks-like-day-to-day","What it looks like day to day",[47,519,521],{"id":520},"chat-to-note","::chat-to-note",[11,523,524],{},"app: cursor\nprompt: Before you touch the billing code, read my Capacities note on the billing redesign and follow the decisions in it.\nreply: 'Read \"Decision: move billing to usage-based pricing\". Keeping invoices monthly and leaving old plans as they are, as the note says. Starting with the price table.'\nnoteLabel: Read from Capacities\nnoteType: Decision\nnoteIcon: i-ph-scales-duotone\nnoteTitle: 'Decision: move billing to usage-based pricing'\nlines:",[156,526,527,530,533],{},[159,528,529],{},"Invoices stay monthly",[159,531,532],{},"Existing plans keep their price",[159,534,535],{},"Linked to Billing project and the call with Maya",[537,538],"hr",{},[11,540,541],{},"::",[11,543,544],{},"Some patterns that work well:",[156,546,547,557,563,569,575,581],{},[159,548,549,552,553,556],{},[30,550,551],{},"Save the essence as an atomic note."," When a conversation produces an insight, say \"save this as an atomic note\". You get one idea, a title that states it, your existing tags, and a link to the source. The ",[21,554,555],{"href":43},"skill at the end"," does this the same way every time.",[159,558,559,562],{},[30,560,561],{},"A decision log."," Make a Decision type with properties for status, date, and project. Ask the agent to read the relevant decisions before it starts, and to write a new one when you settle something in a session.",[159,564,565,568],{},[30,566,567],{},"End-of-session write-back."," \"Write a short note on what we changed today and why, linked to the project.\" Tomorrow's session starts from it.",[159,570,571,574],{},[30,572,573],{},"Meetings become objects."," Paste a transcript and say \"create a Meeting object, link the people, and add the action items as tasks.\"",[159,576,577,580],{},[30,578,579],{},"Research into drafts."," \"List my Source objects tagged #onboarding, read them, and draft the docs page.\"",[159,582,583,586],{},[30,584,585],{},"Ask from anywhere."," On your phone in ChatGPT: \"What did I decide about the billing invoices?\" Same notes, different agent.",[47,588,590],{"id":589},"why-agents-should-write-atomic-notes","Why agents should write atomic notes",[11,592,593],{},"An atomic note holds one idea. Its title states the idea as a claim, such as \"Solar cells need ultra-pure monocrystalline silicon\", not a topic like \"Silicon\". The body is short and makes sense without the conversation it came from. The idea is old. Niklas Luhmann built his Zettelkasten from about 90,000 cards like this. What is new is who reads them.",[11,595,596],{},"Atomic notes are the best unit for an AI second brain, for four reasons.",[11,598,599,602],{},[30,600,601],{},"Search returns the right thing."," An agent finds notes by searching, then reads the ones that look relevant. If the answer is buried in a long page called \"Reading notes 2026\", the agent reads the whole page to find one paragraph, and it fills its context with everything else. If the answer is a note whose title says it, the agent finds it in one search and reads only what it needs. That is context engineering in practice: just the right information for the next step.",[11,604,605,608],{},[30,606,607],{},"Titles do the work."," A title that states the idea is a summary the agent sees in search results before it opens anything. You get the same benefit when you scan a list of notes.",[11,610,611,614],{},[30,612,613],{},"One idea links cleanly."," A note about one idea can link to the book it came from, and to the projects where it matters. A long mixed note links to everything, so the links mean nothing. This is the \"links everywhere\" problem from the Obsidian thread.",[11,616,617,620],{},[30,618,619],{},"Small notes are easy to check."," You can read an atomic note in ten seconds and decide if it is right. A page of agent-written summary is harder to check, so mistakes stay in it. This is how knowledge rot starts.",[622,623,625],"h3",{"id":624},"the-two-ways-agent-write-back-goes-wrong","The two ways agent write-back goes wrong",[11,627,628],{},"When agents save notes for you, two mistakes do most of the damage. Both are easy to make, and you notice both too late.",[630,631,632,638],"ol",{},[159,633,634,637],{},[30,635,636],{},"Tags created by accident."," You have a tag \"Solar energy\". The agent tags a new note \"Photovoltaics\", which creates a second tag for the same field. Now your notes on one topic are split in two, and neither tag shows everything.",[159,639,640,643,644,647],{},[30,641,642],{},"Links to nothing."," The agent links to ",[123,645,646],{},"[[Material Worlds]]",", but your book is called \"Material World\". The link creates a new, empty object instead of pointing to the book. The note looks linked, but it is not.",[11,649,650,651,654],{},"The fix is a short rule set the agent follows every time: search for existing tags and use only those, look up the exact title of the source before linking, and ask when there is more than one match. You can type those rules into every chat, or you can give them to your assistant once, as a skill. That is what the ",[21,652,653],{"href":43},"skill at the end of this guide"," does.",[47,656,658],{"id":657},"how-to-shape-a-space-agents-use-well","How to shape a space agents use well",[630,660,661,667,675,681,687,693],{},[159,662,663,666],{},[30,664,665],{},"Create the types you actually use."," Meeting, Person, Project, Decision, Source, and Atomic note. Give each the properties you care about. Agents read these and fill them in. Atomic note and many others are ready-made in the Object Studio gallery.",[159,668,669,672,673,513],{},[30,670,671],{},"Write a \"How this space works\" page."," List your types, your tag conventions, and what agents should never do. Tell each agent to read it first, the way you would point it at a ",[123,674,125],{},[159,676,677,680],{},[30,678,679],{},"Use clear titles."," A title that says what the note is about is the single biggest help to search, for you and for agents. For atomic notes, the title is the idea itself.",[159,682,683,686],{},[30,684,685],{},"Keep a short tag list, and grow it yourself."," Tags are how you and your agents find related notes. Tell agents to use existing tags and to suggest new ones instead of creating them.",[159,688,689,692],{},[30,690,691],{},"Keep spaces separate."," Work and personal in different spaces, and connect each agent only to what it needs.",[159,694,695,698],{},[30,696,697],{},"Review once a week."," Agents write fast. Five minutes of deleting and linking keeps the knowledge base from rotting, whichever option you choose.",[47,700,702],{"id":701},"when-you-need-more-than-the-connector","When you need more than the connector",[11,704,705,706,710],{},"The connector is built for working with your notes, not for bulk jobs. For imports, scheduled syncs, or your own tools, use the REST API. It has a public OpenAPI description and a TypeScript SDK, and you can build your own MCP server on top of it. ",[21,707,709],{"href":708},"\u002Fdevelopers","Capacities for developers"," explains what it is for.",[11,712,713],{},"One Believer summed up the connector on X: \"Your MCP Access multiplied the usefulness tenfold!\"",[47,715,717],{"id":716},"who-should-pick-a-markdown-vault-instead","Who should pick a Markdown vault instead",[156,719,720,726,732,738,744],{},[159,721,722,725],{},[30,723,724],{},"You want your agent to edit notes as files",", with grep, bulk rewrites, and Git history. Pick Obsidian or Logseq.",[159,727,728,731],{},[30,729,730],{},"Local files must be the source of truth."," Capacities is a cloud app with Markdown export, not a local-first one.",[159,733,734,737],{},[30,735,736],{},"You need end-to-end encryption."," Capacities is not end-to-end encrypted. Anytype is, and it has a local connector.",[159,739,740,743],{},[30,741,742],{},"Your agents need to design the structure."," They cannot create types or properties in Capacities yet.",[159,745,746,749],{},[30,747,748],{},"Your team shares the knowledge base."," Capacities is for one person.",[47,751,753],{"id":752},"the-skill-save-a-conversation-as-an-atomic-note","The skill: save a conversation as an atomic note",[11,755,756,757,760],{},"A skill is a file of instructions that your assistant loads when a task matches. Claude, ChatGPT, Claude Code, Cursor, and Codex all read the same format: a folder with a ",[123,758,759],{},"SKILL.md"," file. Write the workflow once, and every assistant follows it the same way.",[11,762,763],{},"This skill turns one idea from a conversation into one atomic note in Capacities. It is a short version of the one we use ourselves. It does five things a plain \"save this\" prompt does not:",[156,765,766,773,779,785,791],{},[159,767,768,769,772],{},"It ",[30,770,771],{},"asks where the idea came from",", because only you know, and the link to the source is often the most useful part of the note.",[159,774,768,775,778],{},[30,776,777],{},"links to the exact title"," of the book, podcast, or article in your space, so the link never creates an empty object.",[159,780,768,781,784],{},[30,782,783],{},"uses only tags you already have",", and suggests a new one instead of creating it.",[159,786,768,787,790],{},[30,788,789],{},"writes the title as a claim"," and keeps the body short.",[159,792,768,793,796],{},[30,794,795],{},"replies with a link that opens the note"," in the Capacities desktop app.",[47,798,521],{"id":799},"chat-to-note-1",[11,801,802],{},"app: claude\nprompt: Save the essence of this as an atomic note.\nreply: 'Where did this come from: a book, a podcast, an article, or no source? … Found your book \"Material World\" and the tags Physics and Energy. Saved: Solar cells need ultra-pure monocrystalline silicon.'\nnoteLabel: Created in Capacities\nnoteType: Atomic note\nnoteIcon: i-ph-lightbulb-duotone\nnoteColor: amber\nnoteTitle: Solar cells need ultra-pure monocrystalline silicon\nlines:",[156,804,805,808,811,814],{},[159,806,807],{},"'Core idea: impurities trap the electrons that carry the current'",[159,809,810],{},"Purity of 99.9999% or more, grown as one crystal",[159,812,813],{},"'Tags: Physics, Energy, both already in the space'",[159,815,816],{},"'Source: Material World'\ncaption: One idea, existing tags, and a link to the book it came from.",[537,818],{},[11,820,541],{},[622,822,824],{"id":823},"what-you-need","What you need",[156,826,827,838],{},[159,828,829,830,833,834,508,836,513],{},"Capacities Pro, and Capacities connected to your assistant. See ",[21,831,292],{"href":832},"#setting-it-up-with-capacities",", or the guides for ",[21,835,507],{"href":506},[21,837,512],{"href":511},[159,839,840],{},"An Atomic note type in your space. Add it from the Object Studio gallery. Without it, the skill offers to save a Page instead.",[622,842,844],{"id":843},"add-it-to-your-assistant","Add it to your assistant",[11,846,847,848,851,852,854,855,858],{},"Create a folder called ",[123,849,850],{},"capacities-atomic-note",", and save the skill below in it as ",[123,853,759],{},". The folder name must match the ",[123,856,857],{},"name"," in the file.",[52,860,861,871],{},[55,862,863],{},[58,864,865,868],{},[61,866,867],{},"Assistant",[61,869,870],{},"Where the skill goes",[68,872,873,880,887,897],{},[58,874,875,877],{},[73,876,512],{},[73,878,879],{},"Zip the folder. Open Customize, then Skills, and upload the ZIP. Then turn the skill on.",[58,881,882,884],{},[73,883,507],{},[73,885,886],{},"Zip the folder. Open Plugins, then the Skills tab. Select Create, then Upload from your computer.",[58,888,889,891],{},[73,890,304],{},[73,892,893,894,513],{},"Put the folder in ",[123,895,896],{},"~\u002F.claude\u002Fskills\u002F",[58,898,899,902],{},[73,900,901],{},"Cursor, Codex",[73,903,893,904,907],{},[123,905,906],{},"~\u002F.agents\u002Fskills\u002F",". Both read it from there.",[11,909,910],{},"In Claude, skills need code execution to be turned on. Assistants without skills can use the same text as project instructions.",[622,912,914],{"id":913},"the-skill","The skill",[306,916,920],{"className":917,"code":918,"language":919,"meta":311,"style":311},"language-markdown shiki shiki-themes material-theme-lighter github-light github-dark","---\nname: capacities-atomic-note\ndescription: Save one idea from the conversation as a self-contained Atomic note in the user's Capacities space, tagged only with existing tags and linked to its source. Use when the user says \"save this as an atomic note\", \"keep this\", or asks to save an insight from the chat to Capacities.\n---\n\n# Capacities atomic note\n\nTurn one idea from the conversation into one Atomic note in the user's\nCapacities space.\n\nThe user keeps a curated knowledge graph. Two mistakes damage it:\n\n- Tags created by accident. A near-duplicate like \"Photovoltaics\" next to\n  an existing \"Solar energy\" splits the graph.\n- Links to an empty object, because the title did not match exactly.\n  Most of this workflow exists to avoid those two mistakes.\n\n## Tools\n\nUse the Capacities connector. If its tools are not loaded yet, search for\nthem by description (\"Capacities search objects\", \"Capacities create\nobject\") before you start.\n\nIf the space has no Atomic note type, say so, and offer to save a Page\ninstead.\n\n## Workflow\n\n1. Ask where the idea came from, in one short question: a book, podcast,\n   article, person, or no source? Skip this if the user already said.\n   Ask even when it seems obvious. Only the user knows the source.\n\n2. Find the source. Search Capacities for its title, with an objectType\n   filter such as \"Book\" if you know the type.\n   - One clear match: use its title exactly as returned.\n   - Several or fuzzy matches (typos, dictation errors): show them and ask.\n   - No match: ask whether to link anyway, which creates a new empty\n     object, or to leave the link out.\n\n3. Pick tags from existing tags only. Search with objectType \"Tag\" several\n   times: the broad field, related fields, and synonyms, in every language\n   the space uses. Pick 1 to 3 that fit, and use their exact titles.\n   Never invent a tag: [[New tag]] in the tags property silently creates\n   one. Create a tag only when the user asks. If nothing fits, use no tags\n   and suggest one in your reply.\n\n4. Write the note. Atomic means one idea that makes sense without this\n   conversation. Write in the language of the conversation.\n   - Title: the idea as a statement, not a topic. \"Solar cells need\n     ultra-pure monocrystalline silicon\", not \"Silicon\".\n   - description: one sentence on what the note covers.\n   - Body: short, scannable Markdown. \"## Core idea\" in 2 to 4 sentences,\n     then 1 to 3 short sections with the why, how, examples, or numbers,\n     and an optional one-line takeaway. Keep facts, mechanisms, and\n     numbers. Drop the chat. Do not repeat the title as a heading.\n   - If the conversation holds several ideas, ask whether the user wants\n     one note or several linked notes.\n\n5. End the body with the source: a line with three dashes, then one line\n   such as \"Source: [[Material World]]\", with the exact title from step 2.\n   Fit the words to the source: \"Heard on [[Podcast]]\", \"From [[Article]]\".\n\n6. Create the note. Call getObjectTypeShape(\"Atomic note\"), then\n   createObjectViaMD with the property keys it returned. Set every property\n   in that one call. Keep the object ID it returns. If there is none,\n   search for the exact title with objectType \"Atomic note\".\n\n7. Get a link that opens the app. Call createObjectLink with the note's ID.\n   It returns https:\u002F\u002Fapp.capacities.io\u002F\u003CspaceId>\u002F\u003CobjectId>. Replace\n   https:\u002F\u002Fapp.capacities.io\u002F with capacities:\u002F\u002F and show it as a Markdown\n   link with the note title as the text. Do this for every note you created\n   or changed. If you cannot get a link, say so and give the exact title.\n\n## Reply\n\nKeep it short. The link comes first:\n\nSaved: [Solar cells need ultra-pure monocrystalline silicon](capacities:\u002F\u002F\u003CspaceId>\u002F\u003CobjectId>)\nTags: Physics, Energy · Source: Material World\nSuggested new tag: none\n","markdown",[123,921,922,927,932,937,941,947,952,956,961,967,972,978,983,989,995,1001,1007,1012,1018,1023,1029,1035,1041,1046,1052,1058,1063,1069,1074,1080,1086,1092,1097,1103,1109,1115,1121,1127,1133,1138,1144,1150,1156,1162,1168,1174,1179,1185,1191,1197,1203,1209,1215,1221,1227,1233,1239,1245,1250,1256,1262,1268,1273,1279,1285,1291,1297,1302,1308,1314,1320,1326,1332,1337,1343,1348,1354,1359,1365,1371],{"__ignoreMap":311},[315,923,924],{"class":317,"line":318},[315,925,926],{},"---\n",[315,928,929],{"class":317,"line":377},[315,930,931],{},"name: capacities-atomic-note\n",[315,933,934],{"class":317,"line":397},[315,935,936],{},"description: Save one idea from the conversation as a self-contained Atomic note in the user's Capacities space, tagged only with existing tags and linked to its source. Use when the user says \"save this as an atomic note\", \"keep this\", or asks to save an insight from the chat to Capacities.\n",[315,938,939],{"class":317,"line":413},[315,940,926],{},[315,942,943],{"class":317,"line":438},[315,944,946],{"emptyLinePlaceholder":945},true,"\n",[315,948,949],{"class":317,"line":473},[315,950,951],{},"# Capacities atomic note\n",[315,953,954],{"class":317,"line":479},[315,955,946],{"emptyLinePlaceholder":945},[315,957,958],{"class":317,"line":485},[315,959,960],{},"Turn one idea from the conversation into one Atomic note in the user's\n",[315,962,964],{"class":317,"line":963},9,[315,965,966],{},"Capacities space.\n",[315,968,970],{"class":317,"line":969},10,[315,971,946],{"emptyLinePlaceholder":945},[315,973,975],{"class":317,"line":974},11,[315,976,977],{},"The user keeps a curated knowledge graph. Two mistakes damage it:\n",[315,979,981],{"class":317,"line":980},12,[315,982,946],{"emptyLinePlaceholder":945},[315,984,986],{"class":317,"line":985},13,[315,987,988],{},"- Tags created by accident. A near-duplicate like \"Photovoltaics\" next to\n",[315,990,992],{"class":317,"line":991},14,[315,993,994],{},"  an existing \"Solar energy\" splits the graph.\n",[315,996,998],{"class":317,"line":997},15,[315,999,1000],{},"- Links to an empty object, because the title did not match exactly.\n",[315,1002,1004],{"class":317,"line":1003},16,[315,1005,1006],{},"  Most of this workflow exists to avoid those two mistakes.\n",[315,1008,1010],{"class":317,"line":1009},17,[315,1011,946],{"emptyLinePlaceholder":945},[315,1013,1015],{"class":317,"line":1014},18,[315,1016,1017],{},"## Tools\n",[315,1019,1021],{"class":317,"line":1020},19,[315,1022,946],{"emptyLinePlaceholder":945},[315,1024,1026],{"class":317,"line":1025},20,[315,1027,1028],{},"Use the Capacities connector. If its tools are not loaded yet, search for\n",[315,1030,1032],{"class":317,"line":1031},21,[315,1033,1034],{},"them by description (\"Capacities search objects\", \"Capacities create\n",[315,1036,1038],{"class":317,"line":1037},22,[315,1039,1040],{},"object\") before you start.\n",[315,1042,1044],{"class":317,"line":1043},23,[315,1045,946],{"emptyLinePlaceholder":945},[315,1047,1049],{"class":317,"line":1048},24,[315,1050,1051],{},"If the space has no Atomic note type, say so, and offer to save a Page\n",[315,1053,1055],{"class":317,"line":1054},25,[315,1056,1057],{},"instead.\n",[315,1059,1061],{"class":317,"line":1060},26,[315,1062,946],{"emptyLinePlaceholder":945},[315,1064,1066],{"class":317,"line":1065},27,[315,1067,1068],{},"## Workflow\n",[315,1070,1072],{"class":317,"line":1071},28,[315,1073,946],{"emptyLinePlaceholder":945},[315,1075,1077],{"class":317,"line":1076},29,[315,1078,1079],{},"1. Ask where the idea came from, in one short question: a book, podcast,\n",[315,1081,1083],{"class":317,"line":1082},30,[315,1084,1085],{},"   article, person, or no source? Skip this if the user already said.\n",[315,1087,1089],{"class":317,"line":1088},31,[315,1090,1091],{},"   Ask even when it seems obvious. Only the user knows the source.\n",[315,1093,1095],{"class":317,"line":1094},32,[315,1096,946],{"emptyLinePlaceholder":945},[315,1098,1100],{"class":317,"line":1099},33,[315,1101,1102],{},"2. Find the source. Search Capacities for its title, with an objectType\n",[315,1104,1106],{"class":317,"line":1105},34,[315,1107,1108],{},"   filter such as \"Book\" if you know the type.\n",[315,1110,1112],{"class":317,"line":1111},35,[315,1113,1114],{},"   - One clear match: use its title exactly as returned.\n",[315,1116,1118],{"class":317,"line":1117},36,[315,1119,1120],{},"   - Several or fuzzy matches (typos, dictation errors): show them and ask.\n",[315,1122,1124],{"class":317,"line":1123},37,[315,1125,1126],{},"   - No match: ask whether to link anyway, which creates a new empty\n",[315,1128,1130],{"class":317,"line":1129},38,[315,1131,1132],{},"     object, or to leave the link out.\n",[315,1134,1136],{"class":317,"line":1135},39,[315,1137,946],{"emptyLinePlaceholder":945},[315,1139,1141],{"class":317,"line":1140},40,[315,1142,1143],{},"3. Pick tags from existing tags only. Search with objectType \"Tag\" several\n",[315,1145,1147],{"class":317,"line":1146},41,[315,1148,1149],{},"   times: the broad field, related fields, and synonyms, in every language\n",[315,1151,1153],{"class":317,"line":1152},42,[315,1154,1155],{},"   the space uses. Pick 1 to 3 that fit, and use their exact titles.\n",[315,1157,1159],{"class":317,"line":1158},43,[315,1160,1161],{},"   Never invent a tag: [[New tag]] in the tags property silently creates\n",[315,1163,1165],{"class":317,"line":1164},44,[315,1166,1167],{},"   one. Create a tag only when the user asks. If nothing fits, use no tags\n",[315,1169,1171],{"class":317,"line":1170},45,[315,1172,1173],{},"   and suggest one in your reply.\n",[315,1175,1177],{"class":317,"line":1176},46,[315,1178,946],{"emptyLinePlaceholder":945},[315,1180,1182],{"class":317,"line":1181},47,[315,1183,1184],{},"4. Write the note. Atomic means one idea that makes sense without this\n",[315,1186,1188],{"class":317,"line":1187},48,[315,1189,1190],{},"   conversation. Write in the language of the conversation.\n",[315,1192,1194],{"class":317,"line":1193},49,[315,1195,1196],{},"   - Title: the idea as a statement, not a topic. \"Solar cells need\n",[315,1198,1200],{"class":317,"line":1199},50,[315,1201,1202],{},"     ultra-pure monocrystalline silicon\", not \"Silicon\".\n",[315,1204,1206],{"class":317,"line":1205},51,[315,1207,1208],{},"   - description: one sentence on what the note covers.\n",[315,1210,1212],{"class":317,"line":1211},52,[315,1213,1214],{},"   - Body: short, scannable Markdown. \"## Core idea\" in 2 to 4 sentences,\n",[315,1216,1218],{"class":317,"line":1217},53,[315,1219,1220],{},"     then 1 to 3 short sections with the why, how, examples, or numbers,\n",[315,1222,1224],{"class":317,"line":1223},54,[315,1225,1226],{},"     and an optional one-line takeaway. Keep facts, mechanisms, and\n",[315,1228,1230],{"class":317,"line":1229},55,[315,1231,1232],{},"     numbers. Drop the chat. Do not repeat the title as a heading.\n",[315,1234,1236],{"class":317,"line":1235},56,[315,1237,1238],{},"   - If the conversation holds several ideas, ask whether the user wants\n",[315,1240,1242],{"class":317,"line":1241},57,[315,1243,1244],{},"     one note or several linked notes.\n",[315,1246,1248],{"class":317,"line":1247},58,[315,1249,946],{"emptyLinePlaceholder":945},[315,1251,1253],{"class":317,"line":1252},59,[315,1254,1255],{},"5. End the body with the source: a line with three dashes, then one line\n",[315,1257,1259],{"class":317,"line":1258},60,[315,1260,1261],{},"   such as \"Source: [[Material World]]\", with the exact title from step 2.\n",[315,1263,1265],{"class":317,"line":1264},61,[315,1266,1267],{},"   Fit the words to the source: \"Heard on [[Podcast]]\", \"From [[Article]]\".\n",[315,1269,1271],{"class":317,"line":1270},62,[315,1272,946],{"emptyLinePlaceholder":945},[315,1274,1276],{"class":317,"line":1275},63,[315,1277,1278],{},"6. Create the note. Call getObjectTypeShape(\"Atomic note\"), then\n",[315,1280,1282],{"class":317,"line":1281},64,[315,1283,1284],{},"   createObjectViaMD with the property keys it returned. Set every property\n",[315,1286,1288],{"class":317,"line":1287},65,[315,1289,1290],{},"   in that one call. Keep the object ID it returns. If there is none,\n",[315,1292,1294],{"class":317,"line":1293},66,[315,1295,1296],{},"   search for the exact title with objectType \"Atomic note\".\n",[315,1298,1300],{"class":317,"line":1299},67,[315,1301,946],{"emptyLinePlaceholder":945},[315,1303,1305],{"class":317,"line":1304},68,[315,1306,1307],{},"7. Get a link that opens the app. Call createObjectLink with the note's ID.\n",[315,1309,1311],{"class":317,"line":1310},69,[315,1312,1313],{},"   It returns https:\u002F\u002Fapp.capacities.io\u002F\u003CspaceId>\u002F\u003CobjectId>. Replace\n",[315,1315,1317],{"class":317,"line":1316},70,[315,1318,1319],{},"   https:\u002F\u002Fapp.capacities.io\u002F with capacities:\u002F\u002F and show it as a Markdown\n",[315,1321,1323],{"class":317,"line":1322},71,[315,1324,1325],{},"   link with the note title as the text. Do this for every note you created\n",[315,1327,1329],{"class":317,"line":1328},72,[315,1330,1331],{},"   or changed. If you cannot get a link, say so and give the exact title.\n",[315,1333,1335],{"class":317,"line":1334},73,[315,1336,946],{"emptyLinePlaceholder":945},[315,1338,1340],{"class":317,"line":1339},74,[315,1341,1342],{},"## Reply\n",[315,1344,1346],{"class":317,"line":1345},75,[315,1347,946],{"emptyLinePlaceholder":945},[315,1349,1351],{"class":317,"line":1350},76,[315,1352,1353],{},"Keep it short. The link comes first:\n",[315,1355,1357],{"class":317,"line":1356},77,[315,1358,946],{"emptyLinePlaceholder":945},[315,1360,1362],{"class":317,"line":1361},78,[315,1363,1364],{},"Saved: [Solar cells need ultra-pure monocrystalline silicon](capacities:\u002F\u002F\u003CspaceId>\u002F\u003CobjectId>)\n",[315,1366,1368],{"class":317,"line":1367},79,[315,1369,1370],{},"Tags: Physics, Energy · Source: Material World\n",[315,1372,1374],{"class":317,"line":1373},80,[315,1375,1376],{},"Suggested new tag: none\n",[622,1378,1380],{"id":1379},"use-it-then-make-it-yours","Use it, then make it yours",[11,1382,1383,1384,513],{},"Say \"save this as an atomic note\" at the moment something clicks, not at the end of a long session. In Claude Code and Cursor, you can also call the skill by name with ",[123,1385,1386],{},"\u002Fcapacities-atomic-note",[11,1388,1389],{},"The skill is plain text, so change it to fit your space. Some common changes:",[156,1391,1392,1398,1404,1410],{},[159,1393,1394,1397],{},[30,1395,1396],{},"Your own sections."," Replace \"Core idea\" with the headings you use, or write them in your language.",[159,1399,1400,1403],{},[30,1401,1402],{},"A related-notes property."," If your Atomic note type has a property for related notes, tell the skill to fill it when you name them.",[159,1405,1406,1409],{},[30,1407,1408],{},"Today's note."," Add a step that also links the new note from today's daily note.",[159,1411,1412,1415],{},[30,1413,1414],{},"A second type."," Copy the skill for Decisions or Definitions, with the properties those types have.",[47,1417,1419],{"id":1418},"how-we-wrote-this-guide","How we wrote this guide",[156,1421,1422,1435,1454,1476],{},[159,1423,1424,1425,508,1429,1434],{},"We make Capacities. Claims about it come from our ",[21,1426,1428],{"href":500,"rel":1427},[83],"connector docs",[21,1430,1433],{"href":1431,"rel":1432},"https:\u002F\u002Fdocs.capacities.io\u002Fdeveloper\u002Fmodel-context-protocol",[83],"MCP documentation",", checked in October 2026.",[159,1436,1437,1438,508,1443,1448,1449,513],{},"The Markdown-vault quotes are verbatim from public threads in ",[21,1439,1442],{"href":1440,"rel":1441},"https:\u002F\u002Fwww.reddit.com\u002Fr\u002FClaudeAI\u002Fcomments\u002F1uwrxbo\u002Fclaude_code_and_obsidian_as_an_aimaintained\u002F",[83],"r\u002FClaudeAI",[21,1444,1447],{"href":1445,"rel":1446},"https:\u002F\u002Fwww.reddit.com\u002Fr\u002FObsidianMD\u002Fcomments\u002F1ruleg8\u002Fyet_another_claudepowered_second_brain_in\u002F",[83],"r\u002FObsidianMD",". The context engineering definitions are from Tobi Lütke and Andrej Karpathy in June 2025, as collected by ",[21,1450,1453],{"href":1451,"rel":1452},"https:\u002F\u002Fwww.langchain.com\u002Fblog\u002Fthe-rise-of-context-engineering",[83],"LangChain",[159,1455,1456,1457,126,1461,126,1465,1469,1470,1475],{},"The skill uses the tools our connector exposes today. Where each assistant loads skills comes from the help pages of ",[21,1458,512],{"href":1459,"rel":1460},"https:\u002F\u002Fsupport.claude.com\u002Fen\u002Farticles\u002F12512180-use-skills-in-claude",[83],[21,1462,507],{"href":1463,"rel":1464},"https:\u002F\u002Fhelp.openai.com\u002Fen\u002Farticles\u002F20001066-skills-in-chatgpt",[83],[21,1466,354],{"href":1467,"rel":1468},"https:\u002F\u002Fcursor.com\u002Fdocs\u002Fskills",[83],", and ",[21,1471,1474],{"href":1472,"rel":1473},"https:\u002F\u002Fdevelopers.openai.com\u002Fcodex\u002Fskills",[83],"Codex",", read in October 2026.",[159,1477,1478,1479,513],{},"If something here is wrong, email ",[21,1480,1482],{"href":1481},"mailto:team@capacities.io","team@capacities.io",[1484,1485,1486],"style",{},"html pre.shiki code .sbgvK, html code.shiki .sbgvK{--shiki-light:#E2931D;--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .s_sjI, html code.shiki .s_sjI{--shiki-light:#91B859;--shiki-default:#032F62;--shiki-dark:#9ECBFF}html pre.shiki code .stzsN, html code.shiki .stzsN{--shiki-light:#91B859;--shiki-default:#005CC5;--shiki-dark:#79B8FF}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sP7_E, html code.shiki .sP7_E{--shiki-light:#39ADB5;--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .s39Yj, html code.shiki .s39Yj{--shiki-light:#39ADB5;--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sseR_, html code.shiki .sseR_{--shiki-light:#9C3EDA;--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sZMiF, html code.shiki .sZMiF{--shiki-light:#E2931D;--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .srdBf, html code.shiki .srdBf{--shiki-light:#F76D47;--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sjJ54, html code.shiki .sjJ54{--shiki-light:#39ADB5;--shiki-default:#032F62;--shiki-dark:#9ECBFF}html pre.shiki code .swQdS, html code.shiki .swQdS{--shiki-light:#E53935;--shiki-default:#005CC5;--shiki-dark:#79B8FF}",{"title":311,"searchDepth":377,"depth":377,"links":1488},[1489,1490,1491,1492,1493,1494,1495,1496,1499,1500,1501,1502,1503,1509],{"id":49,"depth":377,"text":50},{"id":111,"depth":377,"text":112},{"id":142,"depth":377,"text":143},{"id":210,"depth":377,"text":211},{"id":291,"depth":377,"text":292},{"id":516,"depth":377,"text":517},{"id":520,"depth":377,"text":521},{"id":589,"depth":377,"text":590,"children":1497},[1498],{"id":624,"depth":397,"text":625},{"id":657,"depth":377,"text":658},{"id":701,"depth":377,"text":702},{"id":716,"depth":377,"text":717},{"id":752,"depth":377,"text":753},{"id":799,"depth":377,"text":521,"children":1504},[1505,1506,1507,1508],{"id":823,"depth":397,"text":824},{"id":843,"depth":397,"text":844},{"id":913,"depth":397,"text":914},{"id":1379,"depth":397,"text":1380},{"id":1418,"depth":377,"text":1419},"AI second brain",{"heading":1512,"subheading":1513,"secondaryLabel":1514,"secondaryTo":708},"One knowledge base, every agent","Write it down once. Reach it from Claude Code, Cursor, ChatGPT, and your phone.","For developers","Claude Code, Cursor, and Codex work better with your context, and that context should outlive any one agent. A Markdown vault or a notes app your agents can reach? How each works, why atomic notes are the unit that lasts, and a free skill that saves the essence of any conversation as one.",false,"md",[1519,1522,1525,1528,1531,1534,1537,1540,1543,1546],{"question":1520,"answer":1521},"What is an AI second brain?","A personal knowledge base that both you and your AI assistants can read and write. You add notes, decisions, people, and research. Your agents look things up there before they answer, and save what they learn back. The point is that your context outlives any single chat, tool, or model.",{"question":1523,"answer":1524},"What is an atomic note, and why does it suit AI agents?","An atomic note holds one idea, with a title that states the idea, written so it makes sense on its own. The idea comes from the Zettelkasten method. It suits agents because a search returns exactly the idea they need, not a long page they have to read through, and because one idea can be linked and reused anywhere.",{"question":1526,"answer":1527},"How do I add the atomic note skill to Claude or ChatGPT?","Save the skill as `SKILL.md` in a folder called `capacities-atomic-note` and zip the folder. In Claude, open Customize, then Skills, and upload the ZIP. In ChatGPT, open Plugins, then the Skills tab, select Create, and upload it. Claude Code, Cursor, and Codex read the folder from your skills directory. The [skill section](#the-skill-save-a-conversation-as-an-atomic-note) has the steps.",{"question":1529,"answer":1530},"Do I need an Atomic note type in Capacities?","It helps. Add Atomic note from the Object Studio gallery. It comes with a description, tags, and two views: notes without tags, and five random notes to reread. If your space has no Atomic note type, the skill says so and offers to save the note as a Page instead.",{"question":1532,"answer":1533},"Should I use Obsidian or Capacities with Claude Code?","Use Obsidian if you want plain Markdown files that Claude Code reads and rewrites directly, under Git. Use Capacities if you want typed notes you also use on your phone, the same knowledge in ChatGPT, Claude, and Cursor, and no sync or schema to maintain. Some people use both: code docs in the repository, everything else in Capacities.",{"question":1535,"answer":1536},"How do I connect Capacities to Cursor?","In Cursor, open Settings, then MCP, and add a global server with the URL `https:\u002F\u002Fapi.capacities.io\u002Fmcp` and the client ID `cursor_mcp_capacities_public`. Restart Cursor and sign in the first time it uses Capacities. The [setup guide](https:\u002F\u002Fdocs.capacities.io\u002Freference\u002Fai-chat-connectors#cursor) has the exact configuration.",{"question":1538,"answer":1539},"Can an agent edit or delete my notes?","Yes, with write access it can change properties, append, edit and delete blocks, and delete objects. Every block edit saves a version first, so you can restore it. Most agent tools also let you approve each change.",{"question":1541,"answer":1542},"Can an agent create object types in Capacities?","Not yet. It can read a type's properties and create objects of that type, but it cannot create a new type or add properties. You set up types in Capacities, and the agent fills them.",{"question":1544,"answer":1545},"Is there a limit on how many notes an agent can create?","Yes. Objects created through the connector or the API share a quota per account. The limit is 10,000 objects, and it grows by 500 each month after you reach it.",{"question":1547,"answer":1548},"Is there an API as well?","Yes. There is a REST API with an OpenAPI description and a TypeScript SDK. Use it for imports, scheduled jobs, or your own tools. See [Capacities for developers](\u002Fdevelopers).","i-ph-brain-duotone","indigo",null,{},{"name":1554,"path":1555,"backLabel":1554},"Connect AI to your notes","\u002Fconnect-ai-to-your-notes","\u002Fguides\u002Fsecond-brain-for-ai-agents","2026-10-09","17 min read",{"title":1560,"description":1561},"AI Second Brain for Claude, Cursor & ChatGPT + Free Skill","Build a second brain your AI agents read and write. Markdown vault versus a connected notes app, why atomic notes work best, and a free skill for Claude and ChatGPT.","guides\u002Fsecond-brain-for-ai-agents","2026-10-13","GmtR7vbCnrbDYbQvIGu--mz2bsqQkXUBCbczLTYg0Xw",1791910183312]