Skip to content

Lightweight · Open source · Runs on your machine

Build your own 24/7 AI chief of staff.

Push turns Claude Code, Codex, or Pi into an always-on personal assistant. Message it from iMessage, Telegram, or Slack, give it recurring jobs, and let it handle work in the background.

Set up your assistant What it can do  ↓

curl -fsSL https://raw.githubusercontent.com/owainlewis/push/main/install.sh | sh

  • One small binaryNo new agent runtime
  • Always availableHandles messages and scheduled jobs
  • You stay in controlPush state stays on your machine

Background work

Give it a task. Get the answer in chat.

Send a message from your phone. Push runs your coding agent on your machine and sends the result back when the work is done.

Telegram Push is online
You · 18:12

Every weekday at 8am, run my morning brief and send me the three things that need my attention.

Push → CodexDraft ready for approval
Push · 18:14

I drafted your morning brief for weekdays at 8am. Approve it to start the schedule.

Delivered in chatConversation saved

What it does

A personal assistant that keeps working when you step away.

01

Handle background work

Ask it to inspect a repository, research a question, or prepare an update. You do not need to keep a terminal open.

02

Run your daily routines

Schedule a morning brief, weekly review, or any other Markdown job and receive the result automatically in chat.

03

Remember the context

Keep conversation history and assistant context between messages instead of explaining the same work again.

04

Use your existing tools

Keep the MCP servers, skills, permissions, and integrations already configured in Claude Code, Codex, or Pi.

How it works

One lightweight bridge. Your agent does the work.

01Message your assistant

Use iMessage, Telegram, or Slack from wherever you are.

02Push starts the work

It restores the conversation and runs your chosen coding agent in the background.

03Get the result

Push saves the response and sends it back to the same chat.

Push does not replace your coding agent. It handles chat, history, schedules, approvals, and delivery. Claude Code, Codex, or Pi keeps control of models, tools, skills, permissions, and authentication.

See the full architecture

Get started

Build your AI chief of staff

  • Run Push for the first time

    Install the binary, connect one channel, configure a backend, and validate the setup.

    Quickstart

  • Connect your chat

    Set up private iMessage, Telegram, or Slack conversations with narrow sender allowlists.

    Configure channels

  • Design your assistant

    Shape identity, durable context, reusable skills, jobs, and evaluation criteria without duplicating instructions or committing secrets.

    Design the repository

  • Automate recurring work

    Write Markdown runbooks, run them manually, or add cron triggers and send stored results to your primary chat.

    Jobs and schedules

  • Operate it continuously

    Choose permissions, inspect local state, and run Push under launchd or systemd.

    Operations guide

Documentation

Find what you need

If you need to… Read…
install and run one working channel Quickstart
design identity, context, skills, and jobs Designing an assistant
understand every TOML setting Configuration
add recurring or manual work Jobs and schedules
choose backend permissions safely Permissions and security
keep Push online after logout or reboot Run as a service
inspect commands and outputs CLI reference
understand or extend the code Architecture and contributing

Canonical source

These pages are generated directly from the Markdown in the repository's docs/ directory. If the site and source ever disagree, update the Markdown source and rebuild the site.