Shared Memory
One place where your AI agent (Codex, Claude Code and others) remembers what Rakuten knows: decisions, account and partner facts, product behaviour, team conventions. You mostly use it by talking to your agent; the web app at memory.rmgops.com is where you manage who sees what.
How it fits together
Why it exists, how a fact gets in and back out, and who can see what.
Every AI chat starts from zero. What your team decided last month lives in someone’s head, an old thread or a deck, so agents guess and people answer the same question again and again.
When a chat settles something worth keeping, the agent saves it as a short fact. Later, anyone’s agent with access finds it and uses it, and says where it came from.
Agents that know your accounts, partners and rules; fewer repeated questions; new starters up to speed faster; one place to correct a fact once for everyone.
How a fact travels
- 1Settled in a chatSam confirms on a call that Sunny Day Outfitters’ renewal moved to May.
- 2Saved as a recordSam’s agent saves one sentence to the “Sunny Day Outfitters” scope and tells Sam.
- 3Found laterMia asks her agent about the renewal. It finds Sam’s record because Mia is a member.
- 4ExplainedHer agent answers and says: from Sam, 8 October, in the Sunny Day Outfitters scope.
- 5Kept currentIf it changes, someone edits it once and every agent gets the new answer.
Who can see what
Scopes decide who can read a record. Publishing is the only way a record leaves its scope.
| The scope’s members | Everyone else at Rakuten | |
|---|---|---|
| Working records | Yes | No |
| Published copies | Yes | Yes |
| Scope name, owners, size | Yes | Yes, if findable (the default) |
| A sealed scope | Yes | Doesn’t know it exists |
| Your notes | Only you | No |
The words you’ll see
A subject, such as an account, product or project, not a team. Only its members can read its records.
Your private scope. Everyone has one, and it can never be shared.
Runs a scope: people, settings, and any record in it. Every scope keeps at least one owner.
Reads and writes records in the scope. Can change their own records.
A reusable list of people, such as a team. Add it to a scope and everyone in it gets in, including future joiners.
One short fact, with its author, date, facets and label.
Subject tags: account, region, vertical, partner, partner-type, team, product. Records inherit their scope’s facets.
public, internal, confidential or restricted. Unlabelled means internal. A scope’s ceiling is the highest it accepts.
A separate company-wide copy of one record. The working original stays in the scope.
A scope hidden from search, for NDA or confidential work. It can’t publish.
An agent app, such as Claude Code or Codex, that you allowed to use Shared Memory as you by signing in. Disconnect it any time.
Two records that contradict each other, waiting for a person to decide.
Set up in about 10 minutes
Three steps, once per computer. Your agent can walk you through the setup guide if you attach it to a chat.
Go to memory.rmgops.com, enter your @rakuten.com address and click the link in the email. Links work once and expire after 15 minutes.
One command, or your app’s MCP settings, adds Shared Memory. The setup page for Claude Code or Codex has it.
Your agent opens your browser. Click Allow if you just started this sign-in yourself and the page shows your email. Codex users can attach the setup file to a chat and let Codex walk them through it.
The Codex setup file
Attach the file to a new Codex chat and send:
- 1What happens next: a single-use link is emailed to you.
- 2Your Rakuten email address.
- 3Send sign-in link.
Finding your way around
Your scopes are on the left; the selected scope’s tabs are across the top.
- 1Owned by you: scopes you own. Scopes others have added you to appear under Shared with you.
- 2A scope: its name, record count (right) and member count (below).
- 3Private: your own Your notes.
- 4+ New scope.
- 5Service status.
- 6Groups, Apps (connected apps and tokens), and Admin (admins only).
- 7The selected scope and your role in it.
- 8The scope’s tabs: Records, Members, Settings, History.
- 9Disagreements: contradictions waiting for a decision.
- 10Who you’re signed in as.
Reading, labelling and publishing records
A record is the basic unit of Shared Memory: one fact, with who said it and when.
Mostly from agents: when a chat establishes something worth keeping, the agent saves it to the scope that matches the subject and tells you what it saved and where. You can also write one by hand on this tab.
Agents are told not to save progress notes, code, secrets or personal data.
A record’s life
- 1WrittenBy an agent during work, or by hand here.
- 2UsedFound whenever a member’s agent looks up the subject.
- 3CorrectedEdited as things change; old versions are kept.
- 4Shared, optionallyPublished if the whole company should see it.
- 5RetiredDeleted, or flagged when it goes stale.
The record card
- 1Working (members only) or Published (company-wide copy).
- 2Classification label. A dropdown if you wrote the record or own the scope; plain text otherwise.
- 3Author.
- 4Date.
- 5The fact itself.
- 6Tags on this record.
- 7Publish: makes a company-wide copy.
- 8Delete: removes the record for everyone in the scope.
- 9Record id, handy when asking your agent about a specific record.
Labels: how sensitive a record is
Change a label
- Open the label dropdown on the card.
- Pick the new label. It saves straight away and confirms with “Label set to …”.
- 1The label dropdown.
- 2The confirmation.
Publishing: sharing one record with everyone
The copy doesn’t follow later edits to the original. To update it, unpublish it, then publish again.
Anyone in the scope can see that a published copy exists, and authors and owners can take it down at any time.
- Would people outside this scope genuinely need it?
- Is it fine for anyone at Rakuten to read?
- Is it labelled public or internal?
- Is it still true, and will it stay true for a while?
Publish a record
- 1Publish.
- 1“Published copy exists” replaces the button, so it can’t be published twice.
- 1Published.
- 2Its own label.
- 3Unpublish: the only action on a copy.
- 4Its own id.
Unpublish or delete
On the green card. Takes the company-wide copy down; the working record stays. Authors and owners can do it.
On a working card. Removes the record for everyone in the scope. Deleting the original does not take down a published copy, so unpublish first.
Both ask you to confirm, and name the author if it’s someone else’s record.
- 1The confirmation.
Write a record in the web app
- Scroll to the bottom of the Records tab.
- Type one fact in a sentence or two.
- Optionally add tags as JSON, e.g.
{"account":"Acme Corp"}. - Click Add record.
- 1The fact.
- 2Optional tags (JSON).
- 3Add record.
Who’s in the scope
Membership is the only way to read a scope’s records. This tab is where that’s decided.
Members read the scope, add records and fix their own.
Owners also decide who’s in, change settings, and can fix or remove any record. Having two owners means nothing stalls when one is away; a scope always keeps at least one.
The Members tab
- 1A member. (primary contact) marks the owner disputes go to.
- 2Role: owner or member.
- 3Make member on an owner, Make owner on a member.
- 4Remove.
- 5Paste @rakuten.com addresses: commas, semicolons or new lines.
- 6Add.
- 7Groups with access: everyone in these groups, now and later.
- 8Your groups.
- 9Add group.
Paste a list and click Add. Good addresses go in; anything not @rakuten.com is listed with the reason.
Make owner on a member. Two owners means nothing stalls when one is away.
Pick a group and click Add group. New joiners to the group get in automatically.
- 1What you pasted.
- 2Each refused address, with the reason.
- 1Make member on the only owner…
- 2…is refused. Make someone else an owner first.
- 1Remove takes the group’s access away; the group itself stays.
Publishing, visibility, facets and the ceiling
Owners change these; everyone else can see them.
- 1Publishing: greyed out while the scope is sealed.
- 2Visibility: the Sealed switch.
- 3Facets.
- 4Save facets.
- 5Classification ceiling.
- 6Record count and created date.
Publishing switch
Relabel everything
Publish everything
Findable or sealed
Anyone at Rakuten can find the scope by name or facet and see its owners and size, so they ask to join instead of creating a duplicate. They never see records.
Only members know it exists. It never appears in search and can’t publish. Use it for NDA or confidential work.
- 1Sealed is off.
- 2What findable means.
- 1Sealed stays off.
- 2The message says “delete them”: on the Records tab, use Unpublish on each green card, then try again.
Facets
Facets tell agents what the scope is about. Every record in it inherits them. Type them as key=value, key=value, for example:
account=Sunny Day Outfitters, region=au, vertical=fashion, partner-type=cashback
That saves as account=sunny-day-outfitters, region=au, vertical=apparel-accessories, partner-type=loyalty-rewards. Saving replaces the whole set.
All partner-type values (11)
buy-now-pay-later, content-media, coupon-deals, creator-influencer, financial-services, loyalty-rewards, other, shopping-marketplace, sub-network, tech-solutions, unknown
All vertical values (79)
advertising-marketing, advising-investing, ai, airlines, apparel-accessories, appliances, art-collectibles, attractions, auto-dealerships, auto-manufacturer, auto-parts, auto-service, banking, beauty-personal-care, betting-gambling, biotech-pharma, business-consumer-loans, computers-phones-accessories, consulting, consumer-electronics-manufacturer, consumer-electronics-retailer, credit-cards, credit-union, cruises, digital-entertainment-video-music, events-ticketing-platforms, family-toys, finance, fintech, food-delivery, footwear, gaming, gifts-party, grocery-supermarkets, health-wellness, healthcare-provider, holding-company, home-goods, home-improvement, home-loans, hotels, household-services, household-supplies, industrial, insurance, jewelry-watches, k-12, luggage, mass-merchant, media-retailers, moving-storage-services, neobank, non-profit, office-supplies-stationery, online-education, other, personal-development, personal-services, pets-animal-supplies, pr-comms, premium-content, professional-development, recreation-entertainment-hobbies, rental-homes, rental-vehicles, restaurants-cafes, software-internet, sporting-outdoors-fitness, staffing-recruiting, tax, telecommunications, trains, transportation-logistics-services, travel-aggregators, university, utilities-energy, vice, weapons, wine-spirits
- 1What you typed.
- 2The error, followed by the allowed values. It fades after a few seconds, so use the lists above.
Classification ceiling
Delete a scope
- Open the scope’s Settings tab (owners only).
- Click Delete this scope.
- Type the scope’s exact name to confirm.
What happened, and who did it
An append-only log for the scope. Nothing in it can be edited or removed.
- 1When, in your local time.
- 2Who.
- 3What: scope created or updated, members added or removed, records edited, published or deleted.
Creating a scope
Anyone can create one. You become its first owner.
- 1The subject.
- 2Allow members to publish (on by default).
- 3Sealed (off by default).
- 4Create scope.
- 5Cancel.
- Click + New scope.
- Type the subject. Tick Sealed for NDA work.
- Click Create scope.
- In Settings, add facets. In Members, add people or a group.
Teams you can add to scopes in one go
Anyone can create a group. Its owners manage who’s in it.
- 1Your groups.
- 2Group name.
- 3Create.
- 1Your role.
- 2Members.
- 3Scopes it’s been added to.
- 4Where those scopes are listed.
- 5Make member / Make owner.
- 6Remove.
- 7Paste @rakuten.com addresses.
- 8Add member.
- Open Groups (in the menu under your email, top right).
- Type a name and click Create. You’re its first owner.
- Paste addresses and click Add member.
- A scope owner then adds the group from that scope’s Members tab.
Connected apps, and tokens for scripts
Every app you allow is listed under Apps. Disconnecting one leaves the others working.
- 1The token’s name.
- 2When the token expires, if ever.
- 3Revoke cuts off that one tool.
- 4Revoked tokens stay listed.
- 5Script name.
- 6Generate.
When two records contradict each other
Agents never quietly pick a winner. They flag the pair for a person.
- 1What the page is for.
- 2Open disagreements appear here.
- Read both records.
- Fix the wrong one on its Records tab (or ask its owner).
- Click Resolve, or Dismiss if they don’t really conflict.
Using Shared Memory through your agent
This is where most of the value is. Talk normally; the agent does the lookups and the filing.
Turn it off for a chat
| Type in a chat | For the rest of that chat |
|---|---|
#memory off | No lookups, no saving. |
#memory read-only | Lookups only; nothing saved, changed or deleted. |
#memory on | Back to normal. |
A new chat starts back at “on”. With the optional hooks installed, these are enforced; without them, the agent is asked to respect them.
Running a scope
Owners are in charge of their scope, and can fix anything in it. Every change is logged.
Add people and groups, keep a second owner, remove people who’ve moved on. When someone finds your scope and asks to join, add them from Members. There’s no request button yet, so people will contact you directly.
Fix, retag, relabel or delete any record, not just your own. Keep the scope’s facets accurate so agents find it.
Unpublish anything that shouldn’t be company-wide. Seal the scope if the project itself is confidential.
Monthly tidy-up
- Ask your agent: “Let’s tidy the scopes I own.” Approve fixes one batch at a time.
- Check Disagreements for anything involving your scopes.
- On Members: remove leavers, and make sure there are two owners.
- On Settings: are the facets and ceiling still right?
- On Records: anything published that shouldn’t be? Unpublish it.
- Skim History for changes you don’t recognise.
Questions and fixes
Click a question to open it.
Why can’t I see a scope?
You’re not a member, or it’s sealed. Ask your agent to find it; for a findable scope it will tell you who owns it, so you can ask to be added. A sealed scope won’t show up at all.
Why can’t I change this record?
Only its author and the scope’s owners can. You can still write a new record that corrects it, or ask an owner.
Why won’t my scope seal?
Something in it is published. Unpublish each green card on the Records tab, then try again.
Why can’t I turn publishing on?
The scope is sealed. Sealed scopes can’t publish.
Why was my facet value refused?
vertical and partner-type only accept their fixed lists (see Settings). The key itself must be one of account, region, vertical, partner, partner-type, team, product.
Why did Add say “nobody added”?
Only @rakuten.com addresses are accepted. Check the domain and the separators.
Unpublish or Delete?
Unpublish takes down the company-wide copy and keeps the record in the scope. Delete removes the record for everyone in the scope.
I turned publishing off. Why is my record still company-wide?
Turning it off only stops new publishing. Unpublish what’s already out.
Is Your notes really private?
Yes. It can’t be shared or published.
My sign-in link didn’t work.
Links work once and expire after 15 minutes. Request a new one.
My agent says it needs to sign in again.
Sign in from the agent again: in Claude Code, type /mcp and choose shared-memory; in Codex, run codex mcp login shared-memory. This happens after 30 days without use, at least every 90 days, and after you disconnect the app.
A token was exposed. What now?
Revoke it under Apps, Advanced, and generate a new one. Your other tools keep working.
The counts look out of date.
Reload the page.
My new group isn’t in the Add group list.
Reload the page and open the Members tab again.
The agent saved something in the wrong place.
Ask “where did that come from?”, then delete it on the web or ask the agent to move it. Next time, tell it which scope to use.