perokit

Pero — AI skill for Claude Code

AI community

Pero — open-source Personal Agent Runtime for running an always-on AI assistant on your VPS — Telegram, scheduled tasks, tools, background workflows, and proactive messaging.

How to install Pero

This entry records only its repository, not the path inside it, so there is no exact command to give. Open perokit/pero and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Pero does

Pero — open-source Personal Agent Runtime for running an always-on AI assistant on your VPS — Telegram, scheduled tasks, tools, background workflows, and proactive messaging. It runs on your existing Claude or Codex subscription.

Alternatives in AI

  • Agmsg — Cross-vendor messaging for CLI AI coding agents — let Claude Code, Codex, Gemini & Copilot talk to each other 1.5k ★
  • OpenContext — A personal context store for AI agents and assistants—reuse your existing coding agent CLI (Codex/Claude/OpenC 1.1k ★
  • Second Brain Starter — Build your own AI Second Brain with Claude Code - a skill that generates a personalized PRD for a proactive, p 377 ★

README

pero

Pero — open-source Personal Agent Runtime for running an always-on AI assistant on your VPS — Telegram, scheduled tasks, tools, background workflows, and proactive messaging. It runs on your existing Claude or Codex subscription.

npm install -g @perokit/pero
pero run

Repository: https://github.com/perokit/pero

Development

Requires Node.js 22.17+ or 24.11+; development uses Node 24 (see `.nvmrc`).

npm ci
npm run build          # compile to dist/
npm run start:dev      # daemon in watch mode (GET http://127.0.0.1:7717/health)
npm run cli -- --help  # built `pero` CLI
npm test               # unit tests (Vitest)
npm run test:e2e       # e2e tests
npm run lint           # oxlint

Design docs live in [docs/](./docs/README.md).