Skip to content

Quick Start

Get Atim running in under 5 minutes.

Step 1: Install

curl -fsSL https://raw.githubusercontent.com/zitsen/atim/main/install.sh | bash

Follow the interactive prompts to configure your IM backend (Feishu or Telegram).

Step 2: Start the Service

atim service --start
atim service --status   # verify it's running

Step 3: Chat with the Agent

  1. Add your bot to a Feishu group chat
  2. Enable Topics mode in the group (recommended) for per-topic session isolation
  3. Send any message in the chat (or in a topic)
  4. Atim creates a tmux window and starts Claude Code
  5. Chat naturally — every message goes to the agent, every response comes back
  1. Create a Telegram group
  2. Enable Topics (group settings → Topics / Forum mode)
  3. Add your bot as an admin
  4. Open a new topic and send any message
  5. Atim creates a tmux window and starts Claude Code
  6. Chat naturally

What Happens Under the Hood

Your message  →  Atim receives it via IM webhook / polling
             →  Finds or creates a tmux window binding
             →  Sends keystrokes to the agent's terminal
             →  Agent processes and generates output
             →  Monitor detects new output in JSONL log / SQLite
             →  Atim sends the response back to your IM chat

Next Steps