@inetafrica/open-claudia 1.0.0

package/.env.example

@@ -0,0 +1,11 @@
+TELEGRAM_BOT_TOKEN=your-bot-token-from-botfather
+TELEGRAM_CHAT_ID=your-chat-id
+WORKSPACE=/path/to/your/workspace
+CLAUDE_PATH=/path/to/claude
+WHISPER_CLI=
+WHISPER_MODEL=
+FFMPEG=
+VAULT_FILE=vault.enc
+SOUL_FILE=soul.md
+CRONS_FILE=crons.json
+ONBOARDED=false

package/README.md

@@ -0,0 +1,99 @@
+# Open Claudia
+
+Your always-on AI coding assistant — Claude Code via Telegram.
+
+Send text, voice notes, screenshots, and files from your phone. Claude Code works on your projects and reports back.
+
+## Features
+
+- **Multi-project sessions** — switch between workspace projects
+- **Voice notes** — speak instructions, transcribed locally via Whisper
+- **Screenshots** — send UI mockups, errors, or code screenshots
+- **File sharing** — send and receive files directly in Telegram
+- **Streaming output** — see Claude working in real-time
+- **Cron jobs** — scheduled tasks (standups, git digests, health checks)
+- **Encrypted vault** — store API keys and credentials securely
+- **Customizable soul** — define your assistant's personality and knowledge
+- **Model switching** — toggle between Opus, Sonnet, Haiku
+- **Plan mode, effort levels, budgets** — full Claude Code control from Telegram
+
+## Prerequisites
+
+- [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) installed and authenticated
+- [Node.js](https://nodejs.org/) 18+
+- A Telegram bot token (from [@BotFather](https://t.me/BotFather))
+- (Optional) whisper-cpp + ffmpeg for voice notes
+
+## Install
+
+```bash
+# From npm package
+npm install -g open-claudia
+
+# Or from source
+git clone https://git.coders.africa/agents/open-claudia.git
+cd open-claudia
+npm install
+```
+
+## Setup
+
+```bash
+open-claudia setup
+# or: node setup.js
+```
+
+The setup wizard will:
+1. Detect Claude CLI and dependencies
+2. Ask for your Telegram bot token and verify it
+3. Auto-detect your chat ID
+4. Set a vault password for credential encryption
+5. Optionally install as a background service (macOS launchd / Linux systemd)
+
+## Run
+
+```bash
+open-claudia start    # Start the bot
+open-claudia stop     # Stop the bot
+open-claudia status   # Check if running
+open-claudia logs     # View recent logs
+```
+
+## Telegram Commands
+
+| Command | Description |
+|---------|-------------|
+| `/session` | Pick a project to work on |
+| `/projects` | Browse all workspace projects |
+| `/model` | Switch model (opus/sonnet/haiku) |
+| `/effort` | Set effort level |
+| `/budget` | Set max spend per task |
+| `/plan` | Toggle plan mode |
+| `/continue` | Resume last conversation |
+| `/cron` | Manage scheduled tasks |
+| `/vault` | Manage credentials (password-protected) |
+| `/soul` | View/edit assistant identity |
+| `/stop` | Cancel running task |
+| `/end` | End current session |
+
+## How It Works
+
+```
+Phone (Telegram) → Bot (Node.js) → Claude Code CLI → Your codebase
+                 ←               ←                  ←
+```
+
+The bot spawns `claude -p` for each message, streaming output back to Telegram. It maintains conversation context via `--resume` and passes a system prompt that gives Claude awareness of the Telegram environment, its own configuration files, and the ability to send files/images directly.
+
+## Configuration Files
+
+| File | Purpose |
+|------|---------|
+| `.env` | Telegram token, paths, settings (created by setup) |
+| `soul.md` | Assistant identity and personality (editable) |
+| `crons.json` | Scheduled tasks |
+| `vault.enc` | Encrypted credential store |
+
+## License
+
+MIT

package/bin/cli.js

@@ -0,0 +1,59 @@
+#!/usr/bin/env node
+
+const { execSync } = require("child_process");
+const path = require("path");
+
+const args = process.argv.slice(2);
+const command = args[0] || "help";
+
+const botDir = path.join(__dirname, "..");
+
+switch (command) {
+  case "setup":
+    require(path.join(botDir, "setup.js"));
+    break;
+
+  case "start":
+    console.log("Starting Open Claudia...");
+    require(path.join(botDir, "bot.js"));
+    break;
+
+  case "stop":
+    try {
+      execSync('pkill -f "node.*bot.js"', { stdio: "inherit" });
+      console.log("Stopped.");
+    } catch (e) {
+      console.log("Not running.");
+    }
+    break;
+
+  case "logs":
+    const logFile = path.join(botDir, "bot.log");
+    try {
+      execSync(`tail -50 "${logFile}"`, { stdio: "inherit" });
+    } catch (e) {
+      console.log("No logs found.");
+    }
+    break;
+
+  case "status":
+    try {
+      execSync('pgrep -f "node.*bot.js"', { stdio: "pipe" });
+      console.log("Running.");
+    } catch (e) {
+      console.log("Not running.");
+    }
+    break;
+
+  default:
+    console.log(`
+Open Claudia — AI Coding Assistant via Telegram
+
+Commands:
+  open-claudia setup    Interactive setup wizard
+  open-claudia start    Start the bot
+  open-claudia stop     Stop the bot
+  open-claudia status   Check if running
+  open-claudia logs     View recent logs
+`);
+}