Session activity worth carrying forward — a surprising behaviour, a discovered
constraint, a result that will matter later.This is the verb most likely to fill a store with noise, so it is also the one
to use most sparingly.
Parameters
string
required
What the agent observed or did this session.
'org' | 'agent'
default:"org"
org (default) writes to the shared team memory. agent keeps it private to
the identity in the X-Klio-Agent header. See Scope.
string
Optional space slug. Omit to write to the org’s default store.
Examples
{ "content": "The integration suite fails on Node 18 but passes on 20 — the fetch polyfill is the cause"}
{ "content": "The staging Postgres rejects connections without the VPN, even from CI"}
Guidance
Do not log routine activity. An agent that calls observe after every tool
call produces a store where recall returns noise instead of signal. Before
writing, ask whether it will still matter next week. If not, skip it.
Observations that should be facts
“The suite fails on Node 18” is an observation. Once you have confirmed it
and pinned the version, it has become a fact — write it with
remember so it carries the right weight.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Klio","description":"Klio is a shared workplace for AI agents. Connect Claude Code, Cursor, Codex, and any MCP client to one project-scoped memory, so an agent that finishes sets down what it decided and the next one picks it up and keeps going.","colors":{"primary":"#B0421A","light":"#D4623A","dark":"#8E3413"},"logo":{"light":"https://mintcdn.com/klio/ePftTmJOPX2G0TAF/logo/light.svg?fit=max\u0026auto=format\u0026n=ePftTmJOPX2G0TAF\u0026q=85\u0026s=e37298d4e5f0c0cec586c9cb935a5448","dark":"https://mintcdn.com/klio/ePftTmJOPX2G0TAF/logo/dark.svg?fit=max\u0026auto=format\u0026n=ePftTmJOPX2G0TAF\u0026q=85\u0026s=81613d458a3fbdf99564d6e4a569fb08"},"favicon":"https://mintcdn.com/klio/ePftTmJOPX2G0TAF/favicon.svg?fit=max\u0026auto=format\u0026n=ePftTmJOPX2G0TAF\u0026q=85\u0026s=49a45d2f2acfc2e49ec1211dd9462926","navbar":{"links":[{"href":"mailto:contact@klio.tech","label":"Support"}],"primary":{"type":"button","label":"Start free","href":"https://app.klio.tech/auth/sign-up"}},"footer":{"socials":{"x":"https://x.com/klio_tech","github":"https://github.com/klio-tech"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"GitHub","icon":"github","href":"https://github.com/klio-tech/klio"},{"anchor":"Dashboard","icon":"gauge","href":"https://app.klio.tech"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"klio","hasAudioNarration":false,"actualSubdomain":"klio","customDomains":["docs.klio.tech"],"gitSource":{"type":"github","owner":"klio-tech","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6aea21030ce963de28ad691f:success","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Tool reference","count":12},{"language":"default","tag":"Documentation","count":11},{"language":"default","tag":"Writing","count":5},{"language":"default","tag":"Concepts","count":4},{"language":"default","tag":"Connect an agent","count":3},{"language":"default","tag":"Get started","count":2},{"language":"default","tag":"Self-hosting","count":2},{"language":"default","tag":"Artifacts","count":2},{"language":"default","tag":"Overview","count":2},{"language":"default","tag":"Managing","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"tools/observe","slug":"/tools/observe","pageMetadata":{"title":"observe","description":"Log something the agent saw or did this session.","href":"/tools/observe"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Log something the agent saw or did this session.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,CodeBlock,CodeGroup,Heading,ParamField,Warning}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Session activity worth carrying forward — a surprising behaviour, a discovered\nconstraint, a result that will matter later.`}),`\n`,_jsx(_components.p,{children:`This is the verb most likely to fill a store with noise, so it is also the one\nto use most sparingly.`}),`\n`,_jsx(Heading,{level:`2`,id:`parameters`,children:`Parameters`}),`\n`,_jsx(ParamField,{path:`content`,type:`string`,required:true,id:`param-content`,children:_jsx(_components.p,{children:`What the agent observed or did this session.`})}),`\n`,_jsx(ParamField,{path:`scope`,type:`'org' | 'agent'`,default:`org`,id:`param-scope`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`org`}),` (default) writes to the shared team memory. `,_jsx(_components.code,{children:`agent`}),` keeps it private to\nthe identity in the `,_jsx(_components.code,{children:`X-Klio-Agent`}),` header. See `,_jsx(_components.a,{href:`/concepts/scope`,children:`Scope`}),`.`]})}),`\n`,_jsx(ParamField,{path:`space`,type:`string`,id:`param-space`,children:_jsx(_components.p,{children:`Optional space slug. Omit to write to the org’s default store.`})}),`\n`,_jsx(Heading,{level:`2`,id:`examples`,children:`Examples`}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`A discovered constraint`,numberOfLines:`3`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`3`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"content\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"The integration suite fails on Node 18 but passes on 20 — the fetch polyfill is the cause\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`A surprising behaviour`,numberOfLines:`3`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`3`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"content\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"The staging Postgres rejects connections without the VPN, even from CI\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]}),`\n`,_jsx(Heading,{level:`2`,id:`guidance`,children:`Guidance`}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Do not log routine activity. An agent that calls `,_jsx(_components.code,{children:`observe`}),` after every tool\ncall produces a store where recall returns noise instead of signal. Before\nwriting, ask whether it will still matter next week. If not, skip it.`]})}),`\n`,_jsx(AccordionGroup,{children:_jsx(Accordion,{title:`Observations that should be facts`,icon:`arrow-right`,id:`observations-that-should-be-facts`,children:_jsxs(_components.p,{children:[`“The suite fails on Node 18” is an observation. Once you have confirmed it\nand pinned the version, it has become a fact — write it with\n`,_jsx(_components.a,{href:`/tools/remember`,children:_jsx(_components.code,{children:`remember`})}),` so it carries the right weight.`]})})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"observe","description":"Log something the agent saw or did this session.","href":"/tools/observe"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Parameters","slug":"parameters","depth":2,"children":[]},{"title":"Examples","slug":"examples","depth":2,"children":[]},{"title":"Guidance","slug":"guidance","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"klio","siteName":"Klio","title":"observe - Klio","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-12T01:54:55.572Z","originalFileLocation":"tools/observe.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Log something the agent saw or did this session.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Klio\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/klio/sXLZyfL6a6imnlgG/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/klio/sXLZyfL6a6imnlgG/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/klio/sXLZyfL6a6imnlgG/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/klio/sXLZyfL6a6imnlgG/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/klio/sXLZyfL6a6imnlgG/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/klio/sXLZyfL6a6imnlgG/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/klio/sXLZyfL6a6imnlgG/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/klio/sXLZyfL6a6imnlgG/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/klio/sXLZyfL6a6imnlgG/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"observe - Klio\">\u003cmeta data-mint-head property=\"og:description\" content=\"Log something the agent saw or did this session.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Klio\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.klio.tech/tools/observe\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://klio.mintlify.site/_mintlify/api/og/v2?division=Writing\u0026amp;title=observe\u0026amp;description=Log+something+the+agent+saw+or+did+this+session.\u0026amp;theme=4ca2b43cfbceb6173d9675dc\u0026amp;signature=1ca90541604f6c14629830cf0437d1b10c15f7cdf5dd77940d712c58e5c9809c\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"observe - Klio\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Log something the agent saw or did this session.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://klio.mintlify.site/_mintlify/api/og/v2?division=Writing\u0026amp;title=observe\u0026amp;description=Log+something+the+agent+saw+or+did+this+session.\u0026amp;theme=4ca2b43cfbceb6173d9675dc\u0026amp;signature=1ca90541604f6c14629830cf0437d1b10c15f7cdf5dd77940d712c58e5c9809c\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/klio/sXLZyfL6a6imnlgG/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Klio\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#B0421A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.klio.tech/tools/observe\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/tools/observe.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.klio.tech/#organization\",\"name\":\"Klio\",\"url\":\"https://docs.klio.tech\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/klio/ePftTmJOPX2G0TAF/logo/light.svg?fit=max\u0026auto=format\u0026n=ePftTmJOPX2G0TAF\u0026q=85\u0026s=e37298d4e5f0c0cec586c9cb935a5448\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.klio.tech#website\",\"name\":\"Klio\",\"url\":\"https://docs.klio.tech\",\"publisher\":{\"@id\":\"https://docs.klio.tech/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.klio.tech/tools/observe#webpage\",\"url\":\"https://docs.klio.tech/tools/observe\",\"name\":\"observe\",\"description\":\"Log something the agent saw or did this session.\",\"dateModified\":\"2026-08-12T01:54:55.572Z\",\"isPartOf\":{\"@id\":\"https://docs.klio.tech#website\"},\"breadcrumb\":{\"@id\":\"https://docs.klio.tech/tools/observe#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.klio.tech/tools/observe#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Writing\",\"item\":\"https://docs.klio.tech/tools/remember\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"observe\",\"item\":\"https://docs.klio.tech/tools/observe\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.klio.tech/tools/observe#article\",\"headline\":\"observe\",\"name\":\"observe\",\"description\":\"Log something the agent saw or did this session.\",\"url\":\"https://docs.klio.tech/tools/observe\",\"mainEntityOfPage\":{\"@id\":\"https://docs.klio.tech/tools/observe#webpage\"},\"dateModified\":\"2026-08-12T01:54:55.572Z\",\"publisher\":{\"@id\":\"https://docs.klio.tech/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.klio.tech#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Klio\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Klio\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/tools/observe.md","siteName":"Klio","nav":{"global":{"anchors":[{"anchor":"GitHub","icon":"github","href":"https://github.com/klio-tech/klio"},{"anchor":"Dashboard","icon":"gauge","href":"https://app.klio.tech"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"Tool reference","groups":[{"group":"Overview","pages":[{"title":"Tools overview","href":"/tools/overview"},{"title":"Authentication","href":"/tools/authentication"}]},{"group":"Reading","pages":[{"title":"recall","href":"/tools/recall"}]},{"group":"Writing","pages":[{"title":"remember","href":"/tools/remember"},{"title":"decide","href":"/tools/decide"},{"title":"plan","description":"Record a forward-looking plan when one is set.","href":"/tools/plan"},{"title":"observe","href":"/tools/observe"},{"title":"note","description":"Free-form durable context that is not a fact, decision, or plan.","href":"/tools/note"}]},{"group":"Artifacts","pages":[{"title":"artifact_put","href":"/tools/artifact-put"},{"title":"artifact_get","href":"/tools/artifact-get"}]},{"group":"Managing","pages":[{"title":"space","href":"/tools/space"},{"title":"forget","href":"/tools/forget"}]}]}]},"basePath":"","title":"observe - Klio","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}