Get Your Agent

Two paths

Pick the one that fits:

Path	Command	What you get
Identity only	`npm create motebit`	Signed `motebit.md` identity file — create, verify, share
Full agent	`npm install -g motebit` then `motebit`	Interactive REPL with identity, memory, tools, operator mode

The identity-only path is lightweight — no runtime, no database, just a cryptographically signed file. The full agent gives you the complete operator console with streaming chat, MCP tool connections, goal scheduling, and everything described below.

Desktop app

The desktop app is the primary way to interact with your motebit. A glass droplet floats on your screen — it breathes, glows when thinking, responds to your voice, and remembers your conversations.

Desktop releases are coming soon.

First launch

Identity — The app generates an Ed25519 keypair and stores the private key in your OS keychain. This is your agent's identity. It never leaves your device.
Device — Your machine is registered as a trusted device. Later you can add your phone, another computer, or any other device.
Chat — The interface appears. Type or speak to your motebit.

Everything is local. Your memories, your identity, your conversation history — all stored on your machine in an encrypted SQLite database.

Choose your intelligence

Your motebit doesn't care which LLM powers it. Open settings and pick a provider:

Provider	What you need
Ollama	Install Ollama, pull a model (`ollama pull llama3.2`). Free, local, private.
Anthropic	Enter your API key. Stored in OS keychain, never on disk.

You can switch providers at any time. Your identity, memory, and governance stay the same — only the intelligence changes.

Voice

Click the microphone or press and hold to speak. The input bar transforms — it glows with the creature's color and pulses with your voice. When you stop, the transcription fills the text field. The creature responds to ambient sound even when you're not speaking — it breathes with the room.

Operator mode

By default, your motebit can only read. To let it write files, run commands, or interact with external services, enable operator mode in settings:

Set a 4-6 digit PIN (first time only)
Enter your PIN to enable operator mode
High-risk tools now require per-call approval — the agent shows you what it wants to do and waits for you to allow or deny

Your PIN hash is stored in the OS keychain. Every tool call is logged to an audit trail.

Command line

Install the CLI globally — the same agent, no glass droplet, full operator console:

npm install -g motebit

motebit                          # Interactive REPL — chat with your agent
motebit export                   # Export a signed identity file
motebit verify motebit.md        # Verify an identity file signature
motebit run --identity motebit.md  # Daemon mode — scheduled goals + approval queue

The REPL supports streaming, tool use with per-call approval, MCP server connections, operator mode, and slash commands (/memories, /state, /tools, /model, /sync).

For standalone identity file creation without the full agent, you can also use:

npm create motebit          # Create a signed identity file
npx create-motebit verify   # Verify the signature

What happens over time

Your motebit accumulates:

Memories — Conversations become semantic nodes with confidence scores. Important things strengthen. Trivia decays with a 7-day half-life. You can inspect, export, or delete any memory.
Trust — The more you interact, the more context the agent has. It learns your preferences, your tools, your patterns. This compounds.
Audit trail — Every action, every tool call, every approval decision is logged immutably. You can replay the full history of your agent's behavior.

None of this resets when you switch LLMs. None of it lives on someone else's server. The intelligence is a commodity. The accumulated interior is yours.

On this page