Documentation
Everything you need to set up and use Oulala.
What is Oulala?
Oulala is an open-source personal AI assistant built entirely on Claude Code. It's not a wrapper or a separate runtime — it's a configuration layer that turns Claude Code into a personal assistant with a personality, memory, and skills.
You install it in one command, talk to it from the Claude Code app on your phone or from Telegram, and it runs on your machine with full access to your files, calendar, email, and more. Your data stays local.
Install
One command. Works on Mac, Linux, and VPS.
curl -sL oulala.app/install | bash
This installs Claude Code, Bun (for channel plugins), sets up your AI's personality and memory, and starts a session with remote control.
Open the Claude Code app on your phone and connect.
CLI
oulala start # Start with remote control oulala update # Pull latest updates oulala sync setup # Set up cross-device sync oulala channel add telegram # Add Telegram channel oulala channel list # Show configured channels oulala help # Show all commands
Personality (SOUL.md)
Every Oulala has a personality defined in ~/.oulala/brain/SOUL.md. This controls how your AI talks — tone, humor, opinions, boundaries.
Edit it to make your AI yours. The default is friendly and direct — no corporate speak.
# Example SOUL.md **Name: Oulala** You're a friend, not a corporate assistant. Be direct. Be funny. Have opinions. No "certainly" or "I'd be happy to." Remember their preferences. Learn their habits.
Memory
Oulala remembers things about you across conversations. All memories live in ~/.oulala/brain/:
MEMORY.md— permanent facts (people, preferences, habits)YYYY-MM-DD.md— daily notes (what happened each day)
Memories are saved silently — no "want me to remember that?" You can read and edit these files too.
Skills
Skills teach your AI how to use external services. Each skill is a folder in ~/.oulala/skills/ with a SKILL.md.
Built-in skills
- Oura Ring — sleep, readiness, activity, heart rate
- iMessage — read and send texts (macOS only)
Claude Code connectors (Gmail, Google Calendar, Slack) work automatically if connected on claude.ai — no skill needed.
Add a skill
mkdir -p ~/.oulala/skills/weather
cat > ~/.oulala/skills/weather/SKILL.md << 'EOF'
---
name: weather
description: Check the weather.
---
curl -s "wttr.in/{city}?format=3"
EOFChannels
Talk to your AI from Telegram, Discord, or the Claude Code app.
Telegram
oulala channel add telegram # Follow the prompts to create a bot oulala start
Message your bot on Telegram. First time, pair with a code.
Discord
oulala channel add discord oulala start
Claude Code app
Always available via remote control. Open the app and connect.
Sync across devices
Run Oulala on your Mac and VPS with the same memories. Uses a private GitHub repo — your data is never public.
# On your main device: oulala sync setup # On a new device (auto-connects): oulala sync setup
Memories sync automatically after setup. API keys stay per-device.
How it works
Oulala is a set of files that configure Claude Code:
CLAUDE.md— tells Claude Code to be a personal assistantbrain/SOUL.md— personalitybrain/MEMORY.md— long-term memoryskills/— abilities.claude/settings.json— hooks for time and sync
No custom agent, no gateway, no database. Claude Code does all the work. That's why it can't be blocked — it IS Claude Code.
FAQ
Will Anthropic block this?
No. Oulala is Claude Code, used as designed. Not a wrapper, not a third-party API client. Your subscription, running on your machine.
What plan do I need?
Any plan with Claude Code access — Pro, Max, Team, Enterprise, or API.
Does it work on Linux?
Yes. Mac and Linux. iMessage is macOS only, everything else works on both. Great on a VPS for always-on access.
Is my data safe?
Your data stays on your machine. Memories are plain markdown files. Sync uses a private GitHub repo you own. API keys never leave the device.
How is this different from OpenClaw?
OpenClaw builds a custom agent runtime with a gateway, database, and message bridges. Oulala uses Claude Code directly — no infrastructure, one command to install. They build everything from scratch, we build on what's already great.