Beluga - AI-native project manager on Sui

Project work with agent memory.

Beluga connects AI agents directly to projects on your machine, then gives those agents persistent memory through Walrus Memory.

Decisions, facts, and context are stored as encrypted, vectorized memory on the Walrus network, so a new chat session or a different model can pick up where the last one stopped.

Local projects. On-chain memory.

Project management

Create, open, rename, and delete local projects, each with its own file tree.

AI agent access

Any MCP-compatible client can connect to Beluga and read or write files inside your projects.

Persistent memory

Context survives ended chats, model changes, and machine switches through encrypted Walrus Memory.

Multiple memories

Attach one or several Walrus Memory accounts or namespaces to the same project.

Built-in Sui wallet

Use an integrated wallet to create Walrus Memory accounts now, with agent signatures and on-chain actions planned.

Sui-first

Designed for Sui dApps and smart contracts, but able to manage any kind of project.

Watch Beluga remember work.

Start with wallet, memory, project, agent.

Beluga turns the documentation flow into a short local setup path: install the app, connect Sui, create memory, attach it to work, and let an MCP client recall the project state.

Install Beluga.

Use the macOS or Windows download when available, or build from source.

Connect Sui.

Import or generate a Sui wallet, with a small amount of SUI for the on-chain memory transaction.

Create Walrus Memory.

Create or import an encrypted memory account, optionally using a namespace such as default to separate context.

Attach it to a project.

Beluga creates the project, links memory, and scaffolds starter files including WALRUS.md, CLAUDE.md, and README.md.

Connect your agent.

Point Claude Desktop, Cursor, or VS Code at Beluga and ask it to open the project and check where you left off.

Use a scoped delegate key from Walrus Playground for memory operations instead of exposing a main wallet key to an agent.

Capabilities

Walrus Memory

Agents store and retrieve project context as encrypted, vectorized memory on the Walrus network.

Sui wallet

Beluga ships with an integrated Sui wallet for creating Walrus Memory accounts and future on-chain agent interactions.

MCP bridge

Claude Desktop, Cursor, VS Code, and other MCP-compatible clients connect to Beluga over a local MCP endpoint.

Delegate keys

Use scoped delegate keys for memory operations instead of exposing a main wallet key to an agent.

How it works

Memory lives on Walrus and is keyed to your account and project, not to a single chat window.

01 / wallet

Create a Sui wallet.

Generate or import a Sui-compatible wallet. Keep a small amount of SUI for creating Walrus Memory accounts.

02 / memory

Create Walrus Memory.

Create or import an on-chain encrypted memory store, with an optional namespace such as default.

03 / project

Attach memory to work.

Create a project, attach one or more memory accounts, and let Beluga scaffold starter files.

04 / mcp

Agents recall and remember.

Point Claude, Cursor, or VS Code at Beluga. Agents call recall() at session start and remember() when context matters.

MCP clients talk to Beluga over one local endpoint.

Beluga exposes project and memory operations through the Model Context Protocol. Claude Desktop, Cursor, and VS Code are supported now; GPT-4 client support is listed as coming soon.

Claude DesktopSupported

Cursor / VS CodeSupported

GPT-4 clientComing soon

Claude Desktop · Cursor · VS Code

Add this server block to claude_desktop_config.json or .cursor/mcp.json at the project root.

{
  "mcpServers": {
    "walrus-memory": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://0.0.0.0:47823/mcp",
        "--allow-http"
      ]
    }
  }
}

The agent gets project, file, and memory tools.

Projects

Project control

project_listList projects with path, file count, and last modified time.
project_openOpen a project, file tree, and attached memory credentials.
project_createCreate a project with starter files.
project_renameRename an existing workspace.
project_deleteRemove a project when it is no longer needed.

Files

File operations

file_readRead a file inside the active project.
file_writeWrite changes and optionally trigger recall plus remember.
file_renameMove or rename a project file.
file_deleteDelete a file from the project.
folder_createCreate, delete, or rename project folders.

Memory

Walrus memory

recallSearch prior project context at the start of a session.
rememberSave important context as a vector embedding.
analyzeExtract discrete facts from a longer passage and store them.

Account health

Network status

get_healthCheck relayer connectivity and memory account status.
get_account_infoReturn wallet address, account ID, and network details.

Resources

Build Beluga. Follow the chain.

Everything a builder needs after the landing page: source install commands, Walrus Memory, Sui network inspection, and the MCP protocol spec.

Build from source

git clone git clone https://github.com/TheRealMagyar/beluga.git
cd beluga
npm install
npm run make

The installer is generated into the out directory.

// sourceGitHub

Source code, releases, and issue tracker for Beluga.