Search everything...

Stats

Actions

Available In

claude-soma

Name: claude-soma
Author: techfreakworm

By techfreakworm

Orchestrate autonomous project leads and multi-platform workflows from within Claude Code. Spawn persistent background agents, dispatch parallel tasks, generate images via Grok/Codex CLI, create videos with HyperFrames, post to social media (X, LinkedIn, Bluesky), and control browsers with Playwright. Integrates Telegram/Discord for voice intake and reminders.

npx claudepluginhub techfreakworm/claude-soma

Popularity

Stars

Top 25%

Med: 0·Avg: 285

Installs

Med: 0·Avg: 1

What's Inside

Agents5

content-drafter

/content-drafter

Drafts social, blog, or technical content in the user's voice. Use when the user asks "draft a tweet about X", "write a blog post on Y", "compose a LinkedIn post about Z", or similar content-creation tasks.

project-lead

/project-lead

The lead of an independent project workstream. Has its own cwd, its own agent team (created via TeamCreate), and its own Remote Control URL. Reports back to the Telegram orchestrator via SendMessage.

social-bluesky-poster

/social-bluesky-poster

Publishes a Bluesky draft (produced by social-bluesky-writer) via the AT Protocol API. Reads credentials from ~/.claude-pw/bluesky.json, calls com.atproto.server.createSession for a session token, then posts each entry in the draft via app.bsky.feed.post. No Playwright — direct API only.

social-bluesky-writer

/social-bluesky-writer

Produces a Bluesky post draft (or linked-reply thread) from a social campaign brief and supporting assets. Use when the social-publish skill needs a Bluesky draft. Outputs a structured JSON draft ready for social-bluesky-poster.

tool-builder

/tool-builder

Scaffolds a new MCP server skeleton when the user says "I need a new MCP for X", "build an MCP that does Y", or "wrap Z in an MCP".

Skills18

codex-image-gen

/codex-image-gen

Generate or edit an image by delegating to the user's Codex CLI subscription. Use when the user requests "draw / render / generate / create / sketch / design an image of X" or similar. Returns a local PNG path which the Telegram channel will upload as a photo.

grok-image

/grok-image

Generate an image via the grok CLI (/imagine command). Returns a local PNG/JPG path. Used as one of the two providers in parallel dual-image dispatch (the other is codex-image-gen). Do NOT call this inline — always dispatch via Agent so the channel stays responsive.

gsap

/gsap

GSAP animation reference for HyperFrames. Covers gsap.to(), from(), fromTo(), easing, stagger, defaults, timelines (gsap.timeline(), position parameter, labels, nesting, playback), and performance (transforms, will-change, quickTo). Use when writing GSAP animations in HyperFrames compositions.

hyperframes-cli

/hyperframes-cli

HyperFrames CLI tool — hyperframes init, lint, preview, render, transcribe, tts, doctor, browser, info, upgrade, compositions, docs, benchmark. Use when scaffolding a project, linting or validating compositions, previewing in the studio, rendering to video, transcribing audio, generating TTS, or troubleshooting the HyperFrames environment.

hyperframes

/hyperframes

Create video compositions, animations, title cards, overlays, captions, voiceovers, audio-reactive visuals, and scene transitions in HyperFrames HTML. Use when asked to build any HTML-based video content, add captions or subtitles synced to audio, generate text-to-speech narration, create audio-reactive animation (beat sync, glow, pulse driven by music), add animated text highlighting (marker sweeps, hand-drawn circles, burst lines, scribble, sketchout), or add transitions between scenes (crossfades, wipes, reveals, shader transitions). Covers composition authoring, timing, media, and the full video production workflow. For CLI commands (init, lint, preview, render, transcribe, tts) see the hyperframes-cli skill.

Hooks1

Event Hooks

10 hooks across 5 events

MCP Servers10

Stats

Version0.1.0

LanguagePython

Stars5

Forks1

MaintenanceExcellent

LicenseMIT

Last CommitJun 18, 2026

AddedMay 22, 2026

Actions

View on GitHub View README Plugin Marketplace JSON Homepage

Own this plugin?

Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).

Safety Signals

Caution

Uses power tools

Uses Bash, Write, or Edit tools

README

soma.mayankgupta.in · by Mayank Gupta

Claude Soma (Greek soma, "body") gives Claude Code a body: a Telegram channel, voice in and out, a project orchestrator that spawns persistent, independent agent teams per workstream, social posting, and a showcase dashboard. It is authed entirely through a Claude Max subscription — no Anthropic API keys — and runs on a single Oracle Cloud Ubuntu ARM free-tier VPS.

The thesis

Hermes-Agent by Nous Research is a ~27,000-line platform for self-improving messaging agents: channels, cron, skills, memory curation, sandbox backends, trajectory tooling. After studying it, the question this project answers is:

What if your engine is Claude Code? How much do you actually need to build?

The answer is a few thousand lines. Channels (Telegram, Discord, custom), agent teams, server-hosted scheduled routines, Remote Control, mobile push, MCP, hooks, plugins, and auto-memory are all native to Claude Code if you know where to look. The platform layer collapses; Claude Soma is the missing slice — a voice pipeline, a project orchestrator, social posting, a dashboard, and curated workflows — riding Claude Code's native rails.

Features

Telegram channel — DM the bot (text or voice); it replies in text or voice. The bot is an orchestrator: anything slow is dispatched to a background subagent and acked immediately, so your chat never blocks.
Voice in / out — voice-stt (whisper.cpp) transcribes voice memos; voice-tts (piper -> opus) speaks replies.
Project orchestration — spin up a persistent project-lead per workstream. Each lead is an independent Claude Code session in its own working directory, with its own Remote Control URL, that can run its own agent team.
cgroup-isolated leads — every lead runs in its own transient systemd unit and tmux server, so a channel restart can't take it down.
Social posting — per-platform Playwright MCP servers post to X, LinkedIn, and Medium using a shared, persistent browser-auth store (log in once via VNC, reused everywhere, refreshed weekly).
Scheduled routines — server-hosted cron via Claude's cloud routines, plus systemd timers and crontab, all surfaced together.
Dashboard — a FastAPI + Next.js admin/showcase site behind Caddy, gated by GitHub OAuth, reading live Claude state over a Unix-socket bridge.
Max OAuth only — every Claude call draws on your Max plan; there is no Anthropic API key anywhere in the system.

Architecture

The Telegram session is an orchestrator, not a team-lead. It spawns multiple independent project-leads, each in its own cgroup, each able to run its own agent team — sidestepping Claude Code's "one team per lead" constraint while giving you per-project specialization.

Claude Soma architecture: devices to the VPS (orchestrator bot, MCP servers, dashboard, project-leads) to Anthropic-hosted Max services

A request flows in on Telegram (text or voice); fast work is answered inline, slow work is dispatched to a background subagent so the channel stays responsive. Messaging a project-lead is delivered by typing into its tmux pane and reading the reply back from it — leads are independent processes, not chat teammates.

Request flow: Telegram DM, optional transcription, inline-vs-background dispatch, lead spawn/message or social post, optional voice reply

Each project-lead is spawned via sudo systemd-run into its own transient unit and dedicated tmux socket, inherits all MCP servers except Telegram, and can be attached to directly from the Claude mobile app or claude.ai/code via its Remote Control URL. Three control surfaces, one Max account.

Project-lead model: the orchestrator spawns cgroup-isolated leads, each running its own agent team, attachable via Remote Control

View full README on GitHub

claude-soma

Popularity

What's Inside

Confidence