Your own AI assistants that remember you. They run on your computer, keep conversations and facts over time, and can talk to you in the terminal or in apps like Telegram and Discord—using the AI provider you choose.
- Node.js version 18 or newer installed on your computer.
- An API key from an AI service you use (for example OpenRouter, OpenAI, or a free local setup with Ollama on your machine). You will paste this during setup.
Open a terminal (Command Prompt, PowerShell, or Terminal on Mac/Linux) and run:
npm install -g cloteragentThen check that it worked:
cloter --helpIf the install fails, make sure Node.js is installed and try again. On some Windows or Linux setups you may need to run the terminal as administrator or use a “sudo” install step—follow what your system asks for.
Connect your AI provider and optionally your chat apps:
cloter config setupThis asks a few questions and saves everything to a file on your computer (in your user folder under .cloter). You do not need to create or edit config files by hand.
Same wizard, different command name:
cloter onboardingTo see what is saved (passwords are hidden):
cloter config listIf something looks wrong, run:
cloter doctor1. Create an assistant (pick any short name, letters and numbers):
cloter create my-assistant2. Chat in the terminal:
cloter chat my-assistantType your messages normally. Commands like /exit or /help work inside the chat (see what the program prints when you start it).
Your assistant remembers the next time you open chat, because data is stored on your machine.
After you add the right tokens in cloter config setup (or with cloter config set…), you can run your assistant on a messenger. Replace my-assistant with the name you created.
| App | Start command |
|---|---|
| Telegram | cloter connect telegram my-assistant |
| Discord | cloter connect discord my-assistant |
| Slack | cloter connect slack my-assistant |
| Others (WhatsApp, Signal, Matrix, LINE, Mattermost, Zulip) | Same pattern: cloter connect <app> my-assistant |
To run several apps at once for the same assistant (only the ones you already configured):
cloter gateway start my-assistantEach platform has its own signup steps (bot tokens from Telegram’s BotFather, Discord Developer Portal, and so on). The setup wizard explains what to paste; you can also run cloter config with no arguments to see reminders.
| What you want | Command |
|---|---|
| Change API keys or tokens later | cloter config setup again, or cloter config set ... (run cloter config --help) |
| List your assistants | cloter list |
| Allow running shell commands in chat (advanced) | cloter chat my-assistant --allow-shell |
| See what’s configured | cloter doctor |
Everything is on your computer, under a folder called .cloter in your home directory:
- Settings (API keys you saved): one file in that folder
- Each assistant: its own subfolder with chat history, memory, and saved “skills”
Nothing is sent to us—only to the AI and chat services you connect.
MIT.