Skip to content

Add the Atlaso Memory plugin#157

Open
imashishkh21 wants to merge 6 commits into
cursor:mainfrom
imashishkh21:add-atlaso-plugin
Open

Add the Atlaso Memory plugin#157
imashishkh21 wants to merge 6 commits into
cursor:mainfrom
imashishkh21:add-atlaso-plugin

Conversation

@imashishkh21

@imashishkh21 imashishkh21 commented Jul 15, 2026

Copy link
Copy Markdown

Add the Atlaso Memory plugin

Adds Atlaso (atlaso/) — automatic long-term memory for Cursor. It recalls what
you've decided and remembers what matters across sessions, projects, and tools, so the
agent starts each session with the relevant context instead of a blank slate.

Homepage: atlaso.ai · Source: atlaso-labs/cursor

What it adds

Component
Hooks sessionStart recalls relevant notes into a rules file; stop/sessionEnd capture the exchange. The automatic loop, zero model involvement.
MCP server (atlaso) 5 tools — recall, remember, forget, recent, status — for deliberate moves.
Rule (alwaysApply, with frontmatter) Orients the agent: treat recall as known context.
Skill Curation judgment — what's worth keeping, personal vs project.

Self-contained — no external binary

The MCP server is lib/mcp.ts, which ships inside the plugin and runs on the bun
Cursor already provides (bun run ${CURSOR_PLUGIN_ROOT}/lib/mcp.ts). There is no
unpublished CLI or npm package to install
— the whole plugin is self-contained and
works on a fresh machine. Rule has valid description + alwaysApply frontmatter; the
skill has name + description; rule and skill are distinct (orientation vs judgment).

Privacy (a memory plugin should be explicit here)

  • Secrets are scrubbed on the user's machine before anything is sent — API keys,
    tokens, and credentialed URLs are redacted client-side (regex + entropy), and again
    server-side.
  • Per-tool credentials. The plugin holds its own token, so removing it revokes only
    Cursor — nothing else on the machine.
  • Fails open. If memory is unreachable, Cursor works exactly as usual — capture and
    recall never block or break a turn.
  • Users own their data and can view/delete any memory at
    app.atlaso.ai/dashboard.

Validation

  • Passes node scripts/validate-plugins.mjs (marketplace + plugin manifests).
  • The plugin is covered by 100+ unit tests plus an offline end-to-end harness in the
    source repo.

Maintained by Atlaso Labs (we ship the same memory for Claude Code, Codex, and
Antigravity). Happy to make any changes the team would like. Contact: hello@atlaso.ai


Note

Medium Risk
Hooks run on every session and turn end and can send scrubbed conversation text to Atlaso’s cloud when linked; auth and per-tool tokens live under ~/.atlaso, though the design is fail-open and gates on entitlement/revocation.

Overview
Adds Atlaso to the marketplace and ships a new self-contained atlaso/ bun/TypeScript plugin for long-term memory (no separate CLI or build step).

Automatic loop (hooks): sessionStart recalls notes from the Atlaso API and writes .cursor/rules/atlaso-recall.mdc in the workspace (workaround for broken additional_context injection). beforeSubmitPrompt / afterAgentResponse stash user/assistant text; stop / sessionEnd gate, scrub secrets, tag personal vs project scope, and batch-deposit to the brain with idempotent client_id and stop/sessionEnd dedupe via completion receipts. First run can spawn a detached PKCE device authorize flow into ~/.atlaso/auth.json.

Supporting client logic: thin REST client with fail-open behavior and verified-only token retirement (x-atlaso-response); per-tool credentials at ~/.atlaso/tools/cursor.json under kernel flock; entitlement caching (free plan = one active tool); project keys from git origin; MCP stdio server for recall / remember / forget / recent / status (mcp.json).

Also includes an alwaysApply rule, memory curation skill, AGENTS.md, docs, license, and changelog.

Reviewed by Cursor Bugbot for commit 825966c. Bugbot is set up for automated code reviews on this repo. Configure here.

Automatic long-term memory for Cursor: recall + capture hooks, the self-contained
atlaso MCP server (recall/remember/forget/recent/status), a usage rule, and a
curation skill. Client-side secret scrub, per-tool credentials, fails open.
Passes scripts/validate-plugins.mjs.
Comment thread atlaso/lib/atlaso.ts
Comment thread atlaso/lib/mcp.ts Outdated
Comment thread atlaso/lib/connect.ts
Comment thread atlaso/lib/credential.ts
Comment thread atlaso/lib/connect.ts
Comment thread atlaso/lib/mcp.ts
Comment thread atlaso/lib/pending.ts
Comment thread atlaso/hooks/capture.ts Outdated
Comment thread atlaso/lib/connect.ts
Comment thread atlaso/hooks/hooks.json
Comment thread atlaso/hooks/capture.ts Outdated
Comment thread atlaso/hooks/capture.ts
Comment thread atlaso/hooks/capture.ts Outdated

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Cursor Bugbot has reviewed your changes using high effort and found 1 potential issue.

There are 2 total unresolved issues (including 1 from previous review).

Fix All in Cursor

Bugbot Autofix is ON, but it could not run because the branch was deleted or merged before autofix could start.

Reviewed by Cursor Bugbot for commit add8d49. Configure here.

Comment thread atlaso/hooks/capture.ts Outdated
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.

1 participant