MsClaw 0.5.0

MsClaw

A .NET toolkit for building AI agents with persistent personalities. Powered by the GitHub Copilot SDK.

MsClaw.Core — a class library to scaffold minds and create configured Copilot SDK clients. MsClaw (global tool) — a CLI gateway that hosts a mind as a running service.

Install

Global Tool

dotnet tool install -g MsClaw
msclaw --help

Library

dotnet add package MsClaw.Core

Quick Start (CLI)

# Scaffold a new mind and start the gateway
msclaw mind scaffold /path/to/my-agent
msclaw start --mind /path/to/my-agent

Quick Start (Library)

using MsClaw.Core;

// Scaffold a new mind
var scaffold = new MindScaffold();
scaffold.Scaffold("/path/to/my-agent");

// Create a CopilotClient pointed at the mind
var client = MsClawClientFactory.Create("/path/to/my-agent");

// Load the mind's identity for session creation
var identity = new IdentityLoader();
var systemMessage = await identity.LoadSystemMessageAsync("/path/to/my-agent");

// Create a session with the mind's personality
var session = await client.CreateSessionAsync(new SessionConfig
{
    SystemMessage = new SystemMessageConfig
    {
        Mode = SystemMessageMode.Replace,
        Content = systemMessage
    }
});

// Chat
var response = await session.SendAndWaitAsync(new MessageOptions { Prompt = "Hello!" });

What is a mind?

A mind is a directory that defines who your agent is and what it remembers:

• SOUL.md — Personality, mission, and boundaries
• .working-memory/ — Persistent memory the agent reads and writes across sessions
• .github/agents/ — Agent instruction files

CLI Commands

msclaw start --mind <path>      Start the gateway daemon
msclaw mind scaffold <path>     Scaffold a new mind directory
msclaw mind validate <path>     Validate a mind has required files
msclaw --version                Print version
msclaw --help                   Usage info

API (MsClaw.Core)

License

Apache 2.0 — see LICENSE for details.