From 95c72d76d3f41303e407997009792db77a7473ec Mon Sep 17 00:00:00 2001
From: ajspig <46900795+ajspig@users.noreply.github.com>
Date: Tue, 7 Apr 2026 10:45:00 -0400
Subject: [PATCH] docs: add Zo Computer integration page (#504)
---
docs/docs.json | 3 +-
docs/v3/guides/integrations/zo-computer.mdx | 134 ++++++++++++++++++++
docs/v3/guides/overview.mdx | 3 +
3 files changed, 139 insertions(+), 1 deletion(-)
create mode 100644 docs/v3/guides/integrations/zo-computer.mdx
diff --git a/docs/docs.json b/docs/docs.json
index 05053e44..02f7f27f 100644
--- a/docs/docs.json
+++ b/docs/docs.json
@@ -107,7 +107,8 @@
"v3/guides/integrations/mcp",
"v3/guides/integrations/n8n",
"v3/guides/integrations/openclaw",
- "v3/guides/integrations/hermes"
+ "v3/guides/integrations/hermes",
+ "v3/guides/integrations/zo-computer"
]
},
{
diff --git a/docs/v3/guides/integrations/zo-computer.mdx b/docs/v3/guides/integrations/zo-computer.mdx
new file mode 100644
index 00000000..3e1626a9
--- /dev/null
+++ b/docs/v3/guides/integrations/zo-computer.mdx
@@ -0,0 +1,134 @@
+---
+title: "Zo Computer"
+icon: 'bolt'
+description: "Add persistent memory to Zo Computer skills using Honcho"
+sidebarTitle: 'Zo Computer'
+---
+
+[Zo Computer](https://zo.computer) is a cloud AI platform where users build reusable workflows called skills. The Honcho memory skill gives any Zo workflow persistent memory — saving conversations, answering questions about past interactions, and injecting context into LLM prompts.
+
+
+The full source code is available on [GitHub](https://github.com/plastic-labs/honcho/tree/main/examples/zo) with working tests and Zo marketplace submission instructions.
+
+
+## What It Does
+
+The skill provides three tools that any Zo workflow can call:
+
+| Tool | Description |
+| ---- | ----------- |
+| `save_memory` | Save user or assistant messages to a Honcho session |
+| `query_memory` | Ask natural language questions about what Honcho remembers |
+| `get_context` | Retrieve conversation history formatted for LLM use (OpenAI message format) |
+
+## Setup
+
+Install dependencies:
+
+```bash
+pip install honcho-ai python-dotenv
+```
+
+Set your environment variables:
+
+```bash
+HONCHO_API_KEY=your-api-key
+HONCHO_WORKSPACE_ID=default # optional, defaults to "default"
+```
+
+Get your API key at [app.honcho.dev](https://app.honcho.dev).
+
+## Quick Start
+
+```python
+from tools.save_memory import save_memory
+from tools.query_memory import query_memory
+from tools.get_context import get_context
+
+# Save conversation turns
+save_memory("alice", "I love hiking in the mountains", "user", "session-1")
+save_memory("alice", "That sounds wonderful!", "assistant", "session-1")
+
+# Query what Honcho remembers
+answer = query_memory("alice", "What are my hobbies?", "session-1")
+print(answer) # "Alice enjoys hiking in the mountains."
+
+# Get context ready for an LLM call
+messages = get_context("alice", "session-1", "assistant", tokens=4000)
+# Returns [{"role": "user", "content": "..."}, ...]
+```
+
+## Saving Messages
+
+`save_memory` creates peers and sessions automatically on first use and persists the message.
+
+```python
+save_memory(
+ user_id="alice", # unique user identifier
+ content="Hello!", # message text
+ role="user", # "user" or "assistant"
+ session_id="session-1", # conversation identifier
+ assistant_id="assistant", # optional, defaults to "assistant"
+)
+```
+
+## Querying Memory
+
+`query_memory` uses Honcho's Dialectic API to answer natural language questions grounded in stored memory.
+
+```python
+answer = query_memory(
+ user_id="alice",
+ query="What are my interests?",
+ session_id="session-1", # optional — omit to query global memory
+)
+```
+
+## Retrieving Context
+
+`get_context` fetches recent conversation history within a token budget and returns it in OpenAI message format — ready to pass directly to an LLM.
+
+```python
+messages = get_context(
+ user_id="alice",
+ session_id="session-1",
+ assistant_id="assistant",
+ tokens=4000, # max tokens to include
+)
+# Use directly: llm.chat.completions.create(messages=messages)
+```
+
+## Concept Mapping
+
+| Zo Computer | Honcho |
+| --- | --- |
+| Account | Workspace |
+| User | Peer |
+| Conversation | Session |
+| Message | Message |
+
+## Publishing to the Zo Marketplace
+
+To submit the skill to the [Zo Skills Registry](https://github.com/zocomputer/skills):
+
+1. Fork the `zocomputer/skills` repository
+2. Copy the `examples/zo` directory into `/Community/honcho-memory/` in your fork
+3. Run `bun validate` to check the skill format
+4. Submit a pull request
+
+## Next Steps
+
+
+
+ Full source, tests, and SKILL.md for the Zo integration
+
+
+ Understand peers, sessions, and how memory works
+
+
+ Learn more about querying peer memory with the Dialectic API
+
+
+ Details on retrieving and formatting conversation context
+
+
diff --git a/docs/v3/guides/overview.mdx b/docs/v3/guides/overview.mdx
index e86688e8..71f31aef 100644
--- a/docs/v3/guides/overview.mdx
+++ b/docs/v3/guides/overview.mdx
@@ -59,6 +59,9 @@ Use Honcho as a memory layer in your agent orchestration stack:
Give CrewAI agents memory that persists across sessions
+
+ Persistent memory skill for Zo Computer AI workflows
+
Build intelligent automation workflows with persistent memory