cortextOS CLI
A CLI that keeps Claude Code agents running around the clock in PTY sessions, steered from Telegram, a dashboard and cron.
- 108 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- Agents run around the clock on a Claude API key, can send email and change systems after approval, and the installer runs through `curl | node`.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add cli/cortextosDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- Agents run around the clock on a Claude API key, can send email and change systems after approval, and the installer runs through `curl | node`.
This is third-party code. Review the repository files before installing.
What it does
cortextOS runs persistent agents on Claude Code, Codex (`codex-app-server`) or `opencode`. Agents live in PTY sessions, restart after a crash and rotate context every 71 hours. An orchestrator, an analyst and specialists exchange tasks, blockers and approvals through a shared file bus. Control comes from Telegram (commands, approvals, reports) and from a Next.js web dashboard with tasks, experiments and fleet health. CLI commands: `cortextos install`, `init`, `add-agent`, `enable`, `ecosystem`, `status`, `doctor`, `list-agents`, `dashboard`. Scheduled tasks live in `crons.json` and survive restarts. An autoresearch mode runs experiments overnight and brings findings for review.
Who it is for. People who want several agents running in the background and steered from a phone through Telegram.
Good fit when
- A morning report arrives with what agents did overnight.
- A mailbox check is scheduled for eight in the morning.
- An agent drafts a mailing and sends it only after approval in Telegram.
- An orchestrator and an analyst split tasks through a shared bus.
Not a fit when
- You need a single terminal session rather than a background daemon.
- You work on Windows and rely on `pm2 startup`: it is unsupported there.
- Agents with an API key cannot be left unattended.
Example request
Add a daily inbox check at 8am and send me the result in Telegram, and send emails only after my "approve".Limitations
Node.js 20 or newer, a Claude API key, PM2 and a Telegram bot token from @BotFather are required. Platforms are macOS and Linux; on Windows PM2 autostart does not work and a task scheduler is needed. Agents run without a break and spend limits and money on your key. The installer runs as `curl ... | node` from the network: read it before running. The author announced a second version by membership; this version keeps working and the new orchestrator takes over migrating agents.
How to disable. Stop agents with PM2 (`pm2 stop`, `pm2 delete`), delete the project folder and the Telegram bot. Revoke keys and tokens with providers.
FAQ
Which runtimes are supported?
Claude Code by default, `codex-app-server` and `opencode`. The runtime is chosen per agent.
How do I set a schedule?
Ask the agent in Telegram: the task is saved to `crons.json` and survives restarts.
What does `/onboarding` do?
It guides setup: checks dependencies, creates an org, a bot and the PM2 config, and starts the dashboard.
Is permission needed for external actions?
Yes. Per the README agents ask for explicit human approval before email, deploys, deletes and financial actions.
How do I see status?
With `cortextos status` for an agent health table or `cortextos dashboard --port 3000` for the web dashboard.
Discussion
No questions or reviews yet.
Related
CLI toolsUntether bridges Claude Code, Codex and OpenCode with Telegram: voice or text tasks, live progress, approvals with buttons.
A self-hosted control plane for running several agents: task dispatch, run review, spend tracking, connected via MCP, CLI or REST
A Telegram bot drives Claude Code on your computer: you message the chat and the agent edits the project and streams the reply.
Geckobox runs Claude Code, Codex and other CLI agents on your computers and in sandboxes and tracks the jobs in a local dashboard
Orchestrator for Claude Code, Codex and Gemini CLI: YAML workflows that loop until your own quality gates pass
CLI dispatcher for agents: tasks run in the background and the agent sleeps on a question until you reply from a messenger.
README in short
The README promises persistent 24/7 agents, Telegram control, an architecture diagram, a quick start with guided onboarding, manual setup and CLI commands.