Docs

Quickstart.

0101 ships AI agents that run locally through Claude Code. The 0101-agents CLI installs them into ~/0101/<agent> and launches Claude Code in that directory.

Prerequisites

Node.js 18 or newer
Claude Code installed and on your PATH
unzip (pre-installed on macOS; apt install unzip on Debian/Ubuntu)

Install the CLI

One global install gives you the 0101-agents command.

$npm install -g 0101-agents

Log in with your license

Grab your license key from your account page. The CLI stores it in ~/.0101/config.json with mode 0600.

$0101-agents login

Install an agent

Downloads the latest release for that agent into ~/0101/<agent>.

$0101-agents install marketer

Start it

Hands the terminal over to Claude Code, with the working directory set to the agent. Exit Claude Code and you land back in your shell.

$0101-agents start marketer

Shortcut for cd ~/0101/marketer && claude

Reference

CLI commands

0101-agents login [<key>]: Save your license key. Prompts if no key is passed.
0101-agents logout: Forget the saved license key.
0101-agents whoami: Show the current license (masked) and API base.
0101-agents install <agent> [--force]: Install an agent. --force overwrites an existing install (wipes data/).
0101-agents update <agent>: Update an installed agent. Preserves data/ and backs it up first.
0101-agents start <agent> [--tg] [-- args]: Open the agent in Claude Code. --tg adds Telegram channel-bot flags.
0101-agents list: List installed agents with their versions.
0101-agents help: Show command summary.

Bonus

Run as a Telegram bot

The --tg flag launches the agent with the channels and permission flags needed for the Telegram plugin.

$0101-agents start marketer --tg

Allow a new user (DM): get their numeric Telegram user id, then in your Claude Code session run:

$/telegram:access allow <senderId>

Add a group: open the group in web.telegram.org — the URL contains the chat id (the digits after #- or #). Groups with topics / sub-chats are supergroups and need a -100 prefix — e.g. a group shown as 1234567890 becomes -1001234567890. Then in Claude Code run:

$/telegram:access group add <groupId>

Add --no-mentionif you don't want to require @-mentioning the bot, or --allow id1,id2 to restrict who in the group the bot will reply to. Make sure the bot is added to the group with permission to read messages.

Where things live

~/.0101/config.json: License key and API base.
~/0101/<agent>/: Installed agent files.
~/0101/<agent>/data/: Memory, projects, custom files — preserved across updates.
~/0101/.backups/: Tarballs of data/ snapshotted before each update.