memcode docs
Agents

Matrix

Run your memcode agent from a Matrix account on any homeserver.

Memcode works with any Matrix homeserver: matrix.org, your own, or your team's. You give the bot its own account and an access token, and it answers in the rooms you put it in.

Step 1: Create an account for the bot

Register a fresh account for the bot on your homeserver, the same way you would create any user account. Give it a recognizable name like @mybot:example.org.

Step 2: Get an access token

Sign in to the bot account with Element, then open Settings → Help & About → Advanced → Access Token and copy the token. Other clients have an equivalent option in their settings.

Step 3: Configure

memcode gateway setup

Choose matrix and enter the homeserver URL (for example https://matrix.example.org) and the access token. When prompted for allowed users, enter the Matrix user ids (like @you:example.org) that may drive the agent.

Step 4: Run

memcode gateway

then invite the bot to a room, or start a direct message with it. DMs, rooms marked as direct, are always answered; in any other room the bot acts only when you mention it.

Encrypted rooms are not supported yet

The bot cannot read encrypted rooms. Use unencrypted rooms for it; that is most public rooms, and any room you create with encryption turned off. If the bot sits silent in a room, check whether the room is encrypted; that is the usual cause.

On this page