Skip to content

feat(right-agent): add Right Agent integration#1599

Open
onsails wants to merge 1 commit into
vectorize-io:mainfrom
onsails:integration/right-agent
Open

feat(right-agent): add Right Agent integration#1599
onsails wants to merge 1 commit into
vectorize-io:mainfrom
onsails:integration/right-agent

Conversation

@onsails
Copy link
Copy Markdown

@onsails onsails commented May 12, 2026

Right Agent (https://github.com/onsails/right-agent) Hindsight integration

@onsails onsails force-pushed the integration/right-agent branch 4 times, most recently from da1beb2 to 24c5e6f Compare May 12, 2026 18:34
@onsails onsails marked this pull request as ready for review May 12, 2026 18:35
Copilot AI review requested due to automatic review settings May 12, 2026 18:35
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds documentation and catalog entries for the “Right Agent” integration so it appears in the Hindsight integrations hub and has a dedicated setup guide in the docs.

Changes:

  • Added a new integrations catalog entry for Right Agent.
  • Added a new Right Agent integration guide page.
  • Added a Right Agent icon asset for the docs site.

Reviewed changes

Copilot reviewed 2 out of 3 changed files in this pull request and generated 3 comments.

File Description
hindsight-docs/src/data/integrations.json Adds the Right Agent integration card metadata (name/description/link/icon).
hindsight-docs/docs-integrations/right-agent.md Adds an end-to-end integration guide (setup, tools, config, troubleshooting).
hindsight-docs/static/img/icons/right-agent.svg Adds the Right Agent icon used by the integrations hub card.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment on lines +174 to +181
"id": "right-agent",
"name": "Right Agent",
"description": "Persistent memory for Right Agent — closed-box AI agents that run Claude Code inside OpenShell sandboxes. One Telegram bot per agent, with a per-chat Claude Code session over a shared, chat-tagged Hindsight bank. Selected during `right init`; auto-retain and auto-recall on every turn.",
"type": "official",
"by": "hindsight",
"category": "framework",
"link": "/sdks/integrations/right-agent",
"icon": "/img/icons/right-agent.svg"
Comment on lines +17 to +20
Install Right Agent and run the init wizard:

```bash
curl -LsSf https://raw.githubusercontent.com/onsails/right-agent/master/install.sh | sh

### Where the Hindsight client runs

Right Agent's MCP aggregator runs on the host — outside the sandbox — and is the only process that talks to the Hindsight API. Agents inside the sandbox call `memory_retain` / `_recall` / `_reflect` over the aggregator's per-agent MCP endpoint, and the aggregator makes the Hindsight calls from the host. The sandbox network policy needs no Hindsight-specific egress rule, and Hindsight credentials never enter the sandbox.
@onsails onsails force-pushed the integration/right-agent branch 2 times, most recently from b17b95a to c1d7a01 Compare May 12, 2026 21:55
@onsails onsails requested a review from Copilot May 13, 2026 00:23
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 2 out of 3 changed files in this pull request and generated 1 comment.

Comments suppressed due to low confidence (1)

hindsight-docs/docs-integrations/right-agent.md:97

  • Similarly, the environment variable example uses a live-looking token (hs_live_...). Consider switching to the same neutral placeholder used elsewhere (e.g. HINDSIGHT_API_KEY=hs_xxx or <your-api-key>) for consistency and to avoid confusion.
If you'd rather keep the API key out of `agent.yaml`, leave `api_key` empty and set `HINDSIGHT_API_KEY` in the environment where `right up` runs:

```bash
export HINDSIGHT_API_KEY=hs_live_xxxxxxxxxxxxxxxx
right up
</details>

Comment on lines +80 to +86
```yaml
memory:
provider: hindsight
api_key: hs_live_xxxxxxxxxxxxxxxx # or omit to use HINDSIGHT_API_KEY env var
bank_id: my-agent # defaults to the agent name
recall_budget: 8000 # optional, token budget for auto-recall
```
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 2 out of 3 changed files in this pull request and generated 3 comments.

{
"id": "right-agent",
"name": "Right Agent",
"description": "Persistent memory for Right Agent — closed-box AI agents that run Claude Code inside OpenShell sandboxes. Hindsight is the native memory provider, selected during `right init`.",
---
sidebar_position: 5
title: "Right Agent Persistent Memory with Hindsight | Integration Guide"
description: "Add persistent memory to Right Agent — closed-box AI agents that run Claude Code inside OpenShell sandboxes. One Telegram bot per agent, with a per-chat Claude Code session over a shared, chat-tagged Hindsight bank. Hindsight is the native memory provider, selected during `right init`."
Comment on lines +68 to +73
| Tool | Purpose |
|---|---|
| `mcp__right__memory_retain(content, context)` | Save a fact permanently with a short label (`"user preference"`, `"api format"`, etc.). |
| `mcp__right__memory_recall(query)` | Ranked semantic + keyword + graph search across the agent's memory. |
| `mcp__right__memory_reflect(query)` | Deep analysis across memories — synthesize patterns, compare past decisions. |

Right Agent (https://github.com/onsails/right-agent) runs Claude Code
inside OpenShell sandboxes, one Telegram thread per agent. Hindsight
is the native, recommended memory provider — selected during
`right init`, with auto-retain and auto-recall on every turn.

Adds:
- integrations.json card (grouped with the other sandboxed-CC peers)
- docs-integrations/right-agent.md integration guide
- right-agent.svg brand mark
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 2 out of 3 changed files in this pull request and generated no new comments.

Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 2 out of 3 changed files in this pull request and generated no new comments.

@benfrank241
Copy link
Copy Markdown
Contributor

What's the status of this PR?

@onsails
Copy link
Copy Markdown
Author

onsails commented May 14, 2026

Ready from my side

What's the status of this PR?

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants