AscendOps

Persistent 24/7 Claude Code agents you control from Telegram or your phone.

---

Telegram chat

You:     Morning. What did you ship overnight?
Boss:    Overnight recap: completed 4 tasks, ran 2 theta-wave
         experiments, drafted 3 content scripts. One item needs
         your approval — I want to email the beta waitlist.
         Check the dashboard or reply "approve".

You:     approve
Boss:    Sent. Email delivered to 47 recipients. Task closed.

You:     Add a cron to check my inbox every morning at 8am.
Boss:    Done. "morning-inbox" cron set — runs daily at 08:00.
         Saved to crons.json — survives restarts automatically.

---

Features

• Persistent agents — Claude Code runs 24/7 in PTY sessions, auto-restarting on crash or after 71-hour context rotation.
• Multi-agent orchestration — Orchestrator, Analyst, and specialist agents coordinate via a shared file bus. Tasks, blockers, and approvals flow automatically.
• Multi-runtime — Run agents on claude-code (default) or OpenAI’s codex-app-server. Both runtimes share the same bus, crons, dashboard, and Telegram integration; pick per-agent.
• Telegram + iOS control — Send commands, approve actions, and get reports from anywhere. Native iOS app coming soon.
• Web dashboard — Full-featured Next.js UI for tasks, approvals, experiments, analytics, and agent fleet health.
• Autoresearch (theta wave) — Agents run autonomous experiments overnight, evaluate results, and surface findings for your review.

---

Architecture

flowchart TD
    U["User (Telegram / iOS)"] --> CLI["cortextOS Daemon (Node.js)"]
    CLI --> O["Orchestrator agent"]
    CLI --> A["Analyst agent"]
    CLI --> W["Specialist agents"]
    O |file bus| A
    O |file bus| W
    CLI --> D["Web Dashboard (Next.js)"]
    D --> U2["Browser / iOS App"]

---

Quick Start

Start with the Zero-to-Fleet Install Guide, or the Windows Install Guide for Windows 10/11. You need Node.js 20.19+ (20.x), 22.13+ (22.x), or 23.5+, Claude Code authenticated with your subscription or API key, and Telegram. The installer sets up PM2 and the CLI; onboarding walks you through your organization and agent bots.

On macOS or Linux:

installer_dir="$(mktemp -d)" && curl -fsSL https://raw.githubusercontent.com/noogalabs/ascendops/main/install.mjs -o "$installer_dir/install.mjs" && node "$installer_dir/install.mjs"
cd ~/ascendops && claude /onboarding

The downloaded .mjs file runs as an ES module on supported Node versions and keeps terminal input available for the installer’s prompts. If you set ASCENDOPS_DIR, use