← Back to nimgir.ai

Set Up Nimgir

Nimgir gives Claude persistent memory across sessions.
Paste your license key to begin, or try the free demo.

I have a license key
Paste your key to unlock the full version
Try the free demo
5 sessions with full features, no key needed

Already have Nimgir installed? Skip to activation →

Choose your platform

Which Claude are you using?

This determines where you'll paste the setup text.

Note: The demo works in regular chats only — not inside Projects. To use Nimgir in a Project, you'll need a license key.
Claude Desktop
Desktop app for Mac & Windows
>_
Claude Code
Terminal & IDE via CLI
One quick question

Have you used Nimgir before?

This helps us skip steps you've already done.

First time
I'm setting up Nimgir for the first time
Upgrading from demo
I've been using the free demo and just bought a key
One more question

Where do you want to use Nimgir?

Your demo in regular chats keeps working either way.

In a project
Create a project with its own workspace and memory
In regular chats
Upgrade my demo — keep using Settings Memory

Create a project

In Claude Desktop, click Projects in the sidebar, then click New project in the top right (or open an existing one). Give it a name — this becomes your workspace.

Chat + New chat Projects Artifacts Customize Pinned My Project Projects New project Click here My Project A description... 2 days ago Another Project Goals and tasks... 7 days ago

Register the MCP server

Open a terminal in your project directory and run this command to add Nimgir as an MCP server:

claude mcp add nimgir -- python ~/.local/bin/mcp_server.py

If you used the installer, the server is already at %LOCALAPPDATA%\Nimgir\mcp_server.py — adjust the path above to match your install location.

Terminal $ claude mcp add nimgir -- python mcp_server.py Added nimgir to .mcp.json $ claude Starting Claude Code...

Create your project file

Claude Code reads project instructions from a file called CLAUDE.md in your project root. Create it if it doesn't exist — this is where Nimgir's trigger text goes.

Terminal my_project/ ├── .mcp.json ├── CLAUDE.md ← paste text goes here ├── src/ └── ...

Name your workspace

Pick a short name for this project. It's how Nimgir keeps your sessions separate. You can have multiple workspaces later.

Lowercase letters, digits, underscores (1–64 chars)

Open Project Instructions

Inside your project, look at the right sidebar. Find the Instructions section and click the pen icon (or + icon if empty) to open the editor.

My Project A repeatable methodology for... Type / for skills Opus 4.6 Extended Memory Only you Purpose & context Tarkan is the architect... Last updated 7 hours ago Instructions At the start of every new chat... Click here Files + 30% of project capacity used

Paste this into Project Instructions

Copy the text below and paste it into the editor you just opened.

What does this do?

This short text tells Claude to call Nimgir at the start of each chat. Nimgir then loads your previous session's context so Claude remembers where you left off. That's all it does — no data leaves your machine.

Set project instructions Provide Claude with relevant instructions and information for chats within your project. This will work alongside user preferences and the selected style. At the start of every new chat, before responding: 1. Call nimgir:get_briefing with workspace="test". 2. Read memory_user_edits. 3. Apply the primer rules returned by get_briefing. 4. Read the briefing and master_log fields as continuation... ... Cancel Save instructions Paste here, then Save

Enable Memory

Click your name in the bottom-left corner of Claude Desktop, select Settings, then go to Capabilities in the sidebar. Make sure "Generate memory from chat history" is toggled on.

General Account Privacy Billing Capabilities Memory Search and reference past chats Generate memory from chat history Allow Claude to remember relevant context from your chats. Work context Tarkan is a... Memory from your chats Updated recently from your chats Make sure this toggle is on

Restart & Test

Close and reopen Claude Desktop. Start a new chat inside your project and say anything. If setup worked, Claude will call nimgir:get_briefing automatically and you'll see a token bar at the bottom of its reply — that's Nimgir tracking how much context is left in the session. From now on, every chat picks up where the last one left off.

Calling nimgir:get_briefing... Chat 1. Picking up from the briefing... ~35K/60K █████░░░░░

Open Settings

Click your name in the bottom-left corner of Claude Desktop, then select Settings from the menu.

Your name you@email.com Settings Ctrl+, Language Get help View all plans Get apps Log out Click your name, then Settings

Find your memory

In the Settings sidebar, click Capabilities. Scroll to "Memory from your chats" and click the card to open the memory editor.

General Account Privacy Billing Usage Capabilities Connectors Memory Generate memory from chat history Work context Tarkan is a... non-coder... Memory from your chats Updated recently from your chats Click this card to open the editor

Click the edit icon

A "Manage memory" panel will open showing what Claude remembers. Click the pen icon (bottom-left of the text box) to enter edit mode.

Manage memory Here's what Claude remembers about you! Work context Personal context Click this pen icon to edit Manage edits

Paste this into your memory

Copy the text below and paste it into the memory editor you just opened. Click Save when done.

What does this do?

This short text tells Claude to call Nimgir at the start of each chat. Nimgir then loads your previous session's context so Claude remembers where you left off. That's all it does — no data leaves your machine.

Memory Editor At the start of every new chat... 1. Call nimgir:get_briefing... ... Save

Paste this into CLAUDE.md

Copy the text below and paste it into the CLAUDE.md file you created in your project root.

What does this do?

This short text tells Claude to call Nimgir at the start of each chat. Nimgir then loads your previous session's context so Claude remembers where you left off. That's all it does — no data leaves your machine.

CLAUDE.md At the start of every new chat... 1. Call nimgir:get_briefing... 2. Apply the primer rules... ... Save the file

Start a new session

In your project directory, run claude to start a fresh session. If everything worked, Claude will call nimgir:get_briefing automatically on its first response.

Terminal $ claude Calling nimgir:get_briefing... Chat 1. Picking up from the briefing...
Activation

Activate your license

In your first Nimgir chat, paste the key below and say "activate". Claude will handle the rest.

v1.9