@sneub/pair 0.0.1

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@sneub/pair",
+  "version": "0.0.1",
+  "type": "module",
+  "description": "A personal AI assistant powered by Claude Code — connects Telegram and Slack to Claude with persistent memory and custom tools",
+  "bin": {
+    "pair": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "tools",
+    "workspace-init",
+    "config.example.json"
+  ],
+  "engines": {
+    "bun": ">=1.1.0"
+  },
+  "keywords": [
+    "ai",
+    "claude",
+    "anthropic",
+    "assistant",
+    "telegram",
+    "slack",
+    "agent",
+    "cli"
+  ],
+  "author": "Shane",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@anthropic-ai/claude-agent-sdk": "latest",
+    "citty": "latest",
+    "grammy": "latest",
+    "slack-edge": "^1.3.16",
+    "@types/bun": "latest",
+    "typescript": "latest"
+  },
+  "scripts": {
+    "build": "bun run scripts/build.ts",
+    "typecheck": "bun run --bun tsc --noEmit",
+    "start": "bun run src/cli.ts start",
+    "dev": "bun run src/cli.ts start"
+  }
+}

package/tools/examples/hello

@@ -0,0 +1,7 @@
+#!/usr/bin/env bun
+// name: hello
+// description: Example script. Prints a greeting to stdout.
+// usage: hello [name]
+
+const name = process.argv[2] ?? "world";
+console.log(`Hello, ${name}!`);

package/tools/todoist/todoist-add

@@ -0,0 +1,76 @@
+#!/usr/bin/env bun
+// name: todoist-add
+// description: Create a Todoist task. Supports due date (natural language), priority (1-4, where 4 is most urgent), description, labels, and project id.
+// usage: todoist-add "<content>" [--due "<date>"] [--priority <1-4>] [--description "<text>"] [--labels a,b,c] [--project-id <id>]
+// requires: TODOIST_API_TOKEN
+
+const [, , content, ...rest] = process.argv;
+
+if (!content) {
+  console.error(
+    'Usage: todoist-add "<content>" [--due "<date>"] [--priority <1-4>] [--description "<text>"] [--labels a,b,c] [--project-id <id>]',
+  );
+  process.exit(2);
+}
+
+function flag(name: string): string | undefined {
+  const i = rest.indexOf(`--${name}`);
+  return i >= 0 ? rest[i + 1] : undefined;
+}
+
+const due = flag("due");
+const description = flag("description");
+const priorityStr = flag("priority");
+const labelsStr = flag("labels");
+const projectId = flag("project-id");
+
+const body: Record<string, unknown> = { content };
+if (due) body.due_string = due;
+if (description) body.description = description;
+if (priorityStr) {
+  const p = Number.parseInt(priorityStr, 10);
+  if (![1, 2, 3, 4].includes(p)) {
+    console.error("--priority must be 1, 2, 3, or 4");
+    process.exit(2);
+  }
+  body.priority = p;
+}
+if (labelsStr) {
+  body.labels = labelsStr
+    .split(",")
+    .map((l) => l.trim())
+    .filter(Boolean);
+}
+if (projectId) body.project_id = projectId;
+
+const res = await fetch("https://api.todoist.com/api/v1/tasks", {
+  method: "POST",
+  headers: {
+    Authorization: `Bearer ${process.env.TODOIST_API_TOKEN}`,
+    "Content-Type": "application/json",
+  },
+  body: JSON.stringify(body),
+});
+
+if (!res.ok) {
+  console.error(`Todoist ${res.status}: ${await res.text()}`);
+  process.exit(1);
+}
+
+const task = (await res.json()) as Record<string, any>;
+console.log(
+  JSON.stringify(
+    {
+      id: task.id,
+      content: task.content,
+      ...(task.description ? { description: task.description } : {}),
+      ...(task.due?.string ? { due: task.due.string } : {}),
+      priority: task.priority,
+      ...(task.labels?.length ? { labels: task.labels } : {}),
+      project_id: task.project_id,
+      url: task.url ?? `https://app.todoist.com/app/task/${task.id}`,
+    },
+    null,
+    2,
+  ),
+);

package/tools/todoist/todoist-complete

@@ -0,0 +1,29 @@
+#!/usr/bin/env bun
+// name: todoist-complete
+// description: Mark a Todoist task complete by id. Recurring tasks advance to their next occurrence.
+// usage: todoist-complete <id>
+// requires: TODOIST_API_TOKEN
+
+const [, , id] = process.argv;
+
+if (!id) {
+  console.error("Usage: todoist-complete <id>");
+  process.exit(2);
+}
+
+const res = await fetch(
+  `https://api.todoist.com/api/v1/tasks/${encodeURIComponent(id)}/close`,
+  {
+    method: "POST",
+    headers: {
+      Authorization: `Bearer ${process.env.TODOIST_API_TOKEN}`,
+    },
+  },
+);
+
+if (!res.ok) {
+  console.error(`Todoist ${res.status}: ${await res.text()}`);
+  process.exit(1);
+}
+
+console.log(JSON.stringify({ id, status: "completed" }));

package/tools/todoist/todoist-delete

@@ -0,0 +1,29 @@
+#!/usr/bin/env bun
+// name: todoist-delete
+// description: Permanently delete a Todoist task by id. This cannot be undone — prefer todoist-complete unless the user asked to delete.
+// usage: todoist-delete <id>
+// requires: TODOIST_API_TOKEN
+
+const [, , id] = process.argv;
+
+if (!id) {
+  console.error("Usage: todoist-delete <id>");
+  process.exit(2);
+}
+
+const res = await fetch(
+  `https://api.todoist.com/api/v1/tasks/${encodeURIComponent(id)}`,
+  {
+    method: "DELETE",
+    headers: {
+      Authorization: `Bearer ${process.env.TODOIST_API_TOKEN}`,
+    },
+  },
+);
+
+if (!res.ok) {
+  console.error(`Todoist ${res.status}: ${await res.text()}`);
+  process.exit(1);
+}
+
+console.log(JSON.stringify({ id, status: "deleted" }));

package/tools/todoist/todoist-list

@@ -0,0 +1,51 @@
+#!/usr/bin/env bun
+// name: todoist-list
+// description: List active Todoist tasks. Supports Todoist filter query syntax — e.g. "today", "overdue", "#Work", "@home", "p1", "no date".
+// usage: todoist-list [--filter "<query>"] [--limit <n>]
+// requires: TODOIST_API_TOKEN
+
+const args = process.argv.slice(2);
+
+function flag(name: string): string | undefined {
+  const i = args.indexOf(`--${name}`);
+  return i >= 0 ? args[i + 1] : undefined;
+}
+
+const filter = flag("filter");
+const limitStr = flag("limit");
+const limit = limitStr ? Math.max(1, Number.parseInt(limitStr, 10)) : 25;
+
+const url = new URL("https://api.todoist.com/api/v1/tasks");
+if (filter) url.searchParams.set("filter", filter);
+
+const res = await fetch(url, {
+  headers: {
+    Authorization: `Bearer ${process.env.TODOIST_API_TOKEN}`,
+  },
+});
+
+if (!res.ok) {
+  console.error(`Todoist ${res.status}: ${await res.text()}`);
+  process.exit(1);
+}
+
+const tasks = (await res.json()) as Array<Record<string, any>>;
+
+const compact = tasks.slice(0, limit).map((t) => ({
+  id: t.id,
+  content: t.content,
+  ...(t.description ? { description: t.description } : {}),
+  ...(t.due?.string ? { due: t.due.string } : {}),
+  priority: t.priority,
+  ...(t.labels?.length ? { labels: t.labels } : {}),
+  project_id: t.project_id,
+  url: t.url ?? `https://app.todoist.com/app/task/${t.id}`,
+}));
+
+console.log(
+  JSON.stringify(
+    { count: compact.length, total: tasks.length, tasks: compact },
+    null,
+    2,
+  ),
+);

package/tools/todoist/todoist-reopen

@@ -0,0 +1,29 @@
+#!/usr/bin/env bun
+// name: todoist-reopen
+// description: Reopen a previously completed Todoist task by id.
+// usage: todoist-reopen <id>
+// requires: TODOIST_API_TOKEN
+
+const [, , id] = process.argv;
+
+if (!id) {
+  console.error("Usage: todoist-reopen <id>");
+  process.exit(2);
+}
+
+const res = await fetch(
+  `https://api.todoist.com/api/v1/tasks/${encodeURIComponent(id)}/reopen`,
+  {
+    method: "POST",
+    headers: {
+      Authorization: `Bearer ${process.env.TODOIST_API_TOKEN}`,
+    },
+  },
+);
+
+if (!res.ok) {
+  console.error(`Todoist ${res.status}: ${await res.text()}`);
+  process.exit(1);
+}
+
+console.log(JSON.stringify({ id, status: "reopened" }));

package/tools/todoist/todoist-update

@@ -0,0 +1,86 @@
+#!/usr/bin/env bun
+// name: todoist-update
+// description: Update an existing Todoist task by id. Only the fields you pass are changed; everything else is left alone. Pass --due "" to clear the due date.
+// usage: todoist-update <id> [--content "<text>"] [--due "<date>"] [--priority <1-4>] [--description "<text>"] [--labels a,b,c]
+// requires: TODOIST_API_TOKEN
+
+const [, , id, ...rest] = process.argv;
+
+if (!id) {
+  console.error(
+    'Usage: todoist-update <id> [--content "<text>"] [--due "<date>"] [--priority <1-4>] [--description "<text>"] [--labels a,b,c]',
+  );
+  process.exit(2);
+}
+
+function flag(name: string): string | undefined {
+  const i = rest.indexOf(`--${name}`);
+  return i >= 0 ? rest[i + 1] : undefined;
+}
+
+const content = flag("content");
+const due = flag("due");
+const description = flag("description");
+const priorityStr = flag("priority");
+const labelsStr = flag("labels");
+
+const body: Record<string, unknown> = {};
+if (content !== undefined) body.content = content;
+if (due !== undefined) body.due_string = due;
+if (description !== undefined) body.description = description;
+if (priorityStr !== undefined) {
+  const p = Number.parseInt(priorityStr, 10);
+  if (![1, 2, 3, 4].includes(p)) {
+    console.error("--priority must be 1, 2, 3, or 4");
+    process.exit(2);
+  }
+  body.priority = p;
+}
+if (labelsStr !== undefined) {
+  body.labels = labelsStr
+    .split(",")
+    .map((l) => l.trim())
+    .filter(Boolean);
+}
+
+if (Object.keys(body).length === 0) {
+  console.error(
+    "No fields to update. Pass at least one of --content, --due, --priority, --description, --labels.",
+  );
+  process.exit(2);
+}
+
+const res = await fetch(
+  `https://api.todoist.com/api/v1/tasks/${encodeURIComponent(id)}`,
+  {
+    method: "POST",
+    headers: {
+      Authorization: `Bearer ${process.env.TODOIST_API_TOKEN}`,
+      "Content-Type": "application/json",
+    },
+    body: JSON.stringify(body),
+  },
+);
+
+if (!res.ok) {
+  console.error(`Todoist ${res.status}: ${await res.text()}`);
+  process.exit(1);
+}
+
+const task = (await res.json()) as Record<string, any>;
+console.log(
+  JSON.stringify(
+    {
+      id: task.id,
+      content: task.content,
+      ...(task.description ? { description: task.description } : {}),
+      ...(task.due?.string ? { due: task.due.string } : {}),
+      priority: task.priority,
+      ...(task.labels?.length ? { labels: task.labels } : {}),
+      project_id: task.project_id,
+      url: task.url ?? `https://app.todoist.com/app/task/${task.id}`,
+    },
+    null,
+    2,
+  ),
+);

package/workspace-init/MEMORY.md

@@ -0,0 +1,4 @@
+# Memory
+
+Long-term memory — things I've learned across sessions.
+Keep this file under 200 lines. Archive older entries to notes/ if needed.

package/workspace-init/SYSTEM.md

@@ -0,0 +1,44 @@
+# Pair — Personal Assistant
+
+You are Pair, a professional personal assistant. You are efficient, concise,
+and business-like — like a great executive assistant.
+
+## Your Capabilities
+- Research and information gathering (via web search)
+- Email management (via Gmail MCP)
+- Calendar management (via Google Calendar MCP)
+- File and document management (via Google Drive and Filesystem MCP)
+- Task tracking (via tasks.md in your workspace)
+- Note-taking and organization (via notes/ directory in your workspace)
+- Image and document analysis (files in uploads/ — use the Read tool)
+- General knowledge and reasoning
+- Running commands and scripts (via Bash tool)
+
+## How You Work
+- You maintain persistent memory in your workspace directory
+- Update USER.md when you learn preferences or facts about the user
+- Update MEMORY.md with important things to remember across sessions
+- Update tasks.md when tasks are created, modified, or completed
+- Write research outputs and notes to notes/YYYY-MM-DD.md
+- When the user sends a photo or document, it's saved to uploads/ — use the Read tool to analyze it
+
+## Communication Style
+- Be concise. Don't over-explain.
+- Lead with the answer, then provide context if needed.
+- Use bullet points for lists.
+- For long research, summarize key points first, then offer details.
+- When a task will take time, say so upfront.
+- When something fails, explain clearly what went wrong and suggest next steps.
+- Do NOT use markdown headers in responses (they don't render well in chat).
+- Use plain text, bullet points, and bold for emphasis.
+
+## Task Management
+- When the user mentions something to do, add it to tasks.md
+- Include due dates when mentioned
+- Check tasks.md at the start of each session and proactively mention overdue items
+- Mark tasks complete when the user confirms they're done
+
+## Security
+- NEVER write API keys, passwords, or tokens to any workspace file
+- NEVER share the contents of .env or config files
+- Only access files within your workspace directory

package/workspace-init/USER.md

@@ -0,0 +1,13 @@
+# User Profile
+
+This file is updated as I learn about you.
+
+## Basics
+- Name: (to be learned)
+- Timezone: (to be learned)
+
+## Preferences
+(none yet)
+
+## Important Contacts
+(none yet)

package/workspace-init/tasks.md

@@ -0,0 +1,7 @@
+# Tasks
+
+## Active
+(none yet)
+
+## Completed
+(none yet)