Skip to content
This repository was archived by the owner on Feb 27, 2026. It is now read-only.

convos: add agent identity context and wire up convos-cli skill#21

Open
saulmc wants to merge 1 commit intostagingfrom
saul/convos-agent-identity
Open

convos: add agent identity context and wire up convos-cli skill#21
saulmc wants to merge 1 commit intostagingfrom
saul/convos-agent-identity

Conversation

@saulmc
Copy link
Copy Markdown
Member

@saulmc saulmc commented Feb 13, 2026

Summary

  • Adds a "Convos Group Chat" section to the AGENTS.md workspace template, establishing that agents are bound to exactly one Convos conversation with isolated context, and should use the /convos-cli skill proactively
  • Wires up the convos-cli skill from @convos/cli via the plugin manifest (openclaw.plugin.json)
  • Adds postinstall shim to make the convos binary available on PATH for agent shell commands

Details

AGENTS.md template — new section explains:

  • 1:1 binding (one agent instance per Convos conversation)
  • Context isolation (no cross-conversation knowledge)
  • Encourages proactive use of Convos capabilities to serve the group

Plugin manifest — adds "skills": ["./skills", "./node_modules/@convos/cli/skills"] so both the local convos-channel skill and the convos-cli skill from the npm package are loaded into the workspace.

postinstall shim — creates a convos binary in the root .bin/ that proxies to the extension's nested @convos/cli binary, since the package is installed from GitHub (not npm) and nested deps don't get hoisted.

Test plan

  • Run openclaw setup on a fresh workspace and verify AGENTS.md contains the Convos section
  • Verify convos-cli appears in the agent's available skills list
  • Verify convos binary is accessible from the project root after pnpm install

🤖 Generated with Claude Code

@macroscopeapp
Copy link
Copy Markdown

macroscopeapp Bot commented Feb 13, 2026

Replace in-process XMTP SDK with ConvosInstance CLI integration and add agent identity context across the Convos channel, HTTP routes, and skills

Switch the Convos extension to a single-process ConvosInstance that shells out to the convos CLI, replace private key handling with identityId, and rewrite setup, onboarding, channel, actions, and HTTP routes to operate on one bound conversation with process-wide instance state and optional bearer auth. Key entry points include index.ts, sdk-client.ts, and channel.ts.

📍Where to Start

Start with the HTTP route and setup flow in index.ts, then review the CLI wrapper ConvosInstance in sdk-client.ts to understand process binding and streaming.


📊 Macroscope summarized e63750f. 15 files reviewed, 40 issues evaluated, 1 issue filtered, 2 comments posted. View details

Comment thread extensions/convos/src/sdk-client.ts
Comment thread extensions/convos/src/sdk-client.ts
@saulmc saulmc changed the base branch from main to staging February 13, 2026 18:48
@macroscopeapp
Copy link
Copy Markdown

macroscopeapp Bot commented Feb 13, 2026

Add agent identity context for Convos group chat and declare Convos CLI skills in openclaw.plugin.json with a postinstall shim in package.json

Add a Convos group chat agent context to AGENTS.md, declare skills paths in openclaw.plugin.json, and add a postinstall script in package.json that writes a convos CLI shim.

📍Where to Start

Start with the skills configuration in openclaw.plugin.json, then review the postinstall script in package.json and the new agent context in AGENTS.md.


Macroscope summarized e63750f.

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant