poke-gate 0.0.8 → 0.1.0

package/.github/workflows/docker.yml

@@ -0,0 +1,41 @@
+name: Build and push Docker image
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  build-and-push:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+
+    steps:
+      - name: Checkout repo
+        uses: actions/checkout@v4
+
+      - name: Log in to GHCR
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Get tag
+        id: vars
+        run: echo "tag=${GITHUB_REF#refs/tags/}" >> "$GITHUB_OUTPUT"
+
+      - name: Build and push
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          push: true
+          tags: |
+            ghcr.io/f/poke-gate:latest
+            ghcr.io/f/poke-gate:${{ steps.vars.outputs.tag }}
+          labels: |
+            org.opencontainers.image.source=https://github.com/f/poke-gate
+            org.opencontainers.image.description=Expose your machine to your Poke AI assistant via MCP tunnel
+            org.opencontainers.image.licenses=MIT

package/.prettierrc

@@ -0,0 +1,7 @@
+{
+  "printWidth": 100,
+  "singleQuote": true,
+  "trailingComma": "all",
+  "endOfLine": "auto",
+  "bracketSpacing": true
+}

package/.remarkignore

@@ -0,0 +1,3 @@
+node_modules/
+dist/
+coverage/

package/.remarkrc.mjs

@@ -0,0 +1,13 @@
+import remarkParse from "remark-parse";
+import remarkStringify from "remark-stringify";
+import presetConsistent from "remark-preset-lint-consistent";
+import presetRecommended from "remark-preset-lint-recommended";
+import listItemIndent from "remark-lint-list-item-indent";
+
+export default {
+  settings: {
+    bullet: "*",
+    listItemIndent: "one"
+  },
+  plugins: [remarkParse, remarkStringify, presetConsistent, presetRecommended, [listItemIndent, "one"]]
+};

package/CODE_OF_CONDUCT.md

@@ -0,0 +1,38 @@
+# Code of Conduct
+
+## Our Commitment
+
+We are committed to a respectful, inclusive, and harassment-free community.
+
+## Expected Behavior
+
+* Be respectful and constructive.
+* Critique ideas, not people.
+* Give and accept feedback professionally.
+* Prioritize the health of the project and community.
+
+## Unacceptable Behavior
+
+* Harassment, discrimination, threats, or personal attacks
+* Insults, intimidation, or hostile behavior
+* Publishing private information without consent
+* Any conduct that creates an unsafe environment
+
+## Enforcement
+
+Project maintainers are responsible for interpreting and enforcing this Code of Conduct. They may remove or reject comments, commits, issues, pull requests, or other contributions that violate these rules.
+
+Possible actions include:
+
+1. Warning
+2. Temporary restriction
+3. Permanent ban
+
+## Reporting
+
+Report unacceptable behavior to maintainers through:
+
+* https://github.com/f/poke-gate/issues
+* https://github.com/f/poke-gate/security/advisories/new
+
+Reports will be reviewed in good faith and handled as privately as possible.

package/CONTRIBUTING.md

@@ -0,0 +1,32 @@
+# Contributing
+
+Thanks for contributing to `poke-gate`.
+
+## How To Contribute
+
+1. Fork the repository.
+2. Create a branch from `main`.
+3. Keep changes small and focused.
+4. Use clear commit messages.
+5. Open a pull request with a short technical summary.
+
+## Local Validation
+
+Before opening a PR, run:
+
+1. `npm install`
+2. `npm run lint`
+3. `npm run lint:md`
+4. `npm run start`
+
+## Pull Request Notes
+
+Include these in the PR description:
+
+1. What changed
+2. Why it changed
+3. How you validated it
+
+## Community Rules
+
+Please read [CODE_OF_CONDUCT.md](./CODE_OF_CONDUCT.md) before contributing.

package/Dockerfile

@@ -0,0 +1,13 @@
+FROM node:20-slim
+
+WORKDIR /app
+
+COPY . .
+
+RUN npm install -g .
+
+LABEL org.opencontainers.image.source="https://github.com/f/poke-gate"
+LABEL org.opencontainers.image.description="Expose your machine to your Poke AI assistant via MCP tunnel"
+LABEL org.opencontainers.image.licenses="MIT"
+
+ENTRYPOINT ["poke-gate"]

package/README.md

@@ -135,6 +135,93 @@ npx poke-gate --verbose
 
 Config is stored at `~/.config/poke-gate/config.json`.
 
+## Agents
+
+Agents are scheduled scripts that run automatically in the background. They live in `~/.config/poke-gate/agents/` and follow a simple naming convention:
+
+```
+<name>.<interval>.js
+```
+
+| File | Runs |
+|------|------|
+| `beeper.1h.js` | Every hour |
+| `backup.2h.js` | Every 2 hours |
+| `health.10m.js` | Every 10 minutes |
+| `cleanup.30m.js` | Every 30 minutes |
+
+Intervals: `Nm` (minutes) or `Nh` (hours). Minimum is 10 minutes.
+
+### Install an agent
+
+Download a community agent from the repository:
+
+```bash
+npx poke-gate agent get beeper
+```
+
+This downloads `beeper.1h.js` and `.env.beeper` to `~/.config/poke-gate/agents/`. Edit the env file with your credentials and test it:
+
+```bash
+nano ~/.config/poke-gate/agents/.env.beeper
+npx poke-gate run-agent beeper
+```
+
+### Per-agent env files
+
+Each agent can have a `.env.<name>` file for secrets:
+
+```
+~/.config/poke-gate/agents/.env.beeper
+```
+
+```env
+BEEPER_TOKEN=your_token_here
+```
+
+Variables are injected into the agent process automatically.
+
+### Agent frontmatter
+
+Each agent file starts with a JSDoc-style frontmatter block:
+
+```javascript
+/**
+ * @agent beeper
+ * @name Beeper Message Digest
+ * @description Fetches messages from the last hour and sends a summary to Poke.
+ * @interval 1h
+ * @env BEEPER_TOKEN - Beeper Desktop local API token
+ * @author f
+ */
+```
+
+### Creating your own agent
+
+An agent is just a JS file that runs with Node.js. It has access to:
+
+- `process.env` — variables from `.env.<name>`
+- `poke` package — `import { Poke, getToken } from "poke"`
+- Any npm package installed globally or via npx
+
+```javascript
+/**
+ * @agent my-agent
+ * @name My Custom Agent
+ * @description Does something useful every 30 minutes.
+ * @interval 30m
+ */
+
+import { Poke, getToken } from "poke";
+
+const poke = new Poke({ apiKey: getToken() });
+await poke.sendMessage("Hello from my agent!");
+```
+
+Save as `~/.config/poke-gate/agents/my-agent.30m.js` and it runs automatically when poke-gate is connected.
+
+Agents start running when poke-gate connects and run once immediately on startup.
+
 ## Security
 
 **Poke Gate grants full shell access to your Poke agent.** This means:
@@ -151,11 +238,16 @@ Only run Poke Gate on machines and networks you trust.
 clients/
   Poke macOS Gate/       macOS menu bar app (SwiftUI)
 bin/
-  poke-gate.js           CLI entry point + onboarding
+  poke-gate.js           CLI entry point, run-agent + agent get subcommands
 src/
-  app.js                 Startup: MCP server + tunnel
+  app.js                 Startup: MCP server + tunnel + agent scheduler
+  agents.js              Agent discovery, scheduling, env loading, download
   mcp-server.js          JSON-RPC MCP handler with OS tools
   tunnel.js              PokeTunnel wrapper
+examples/
+  agents/
+    beeper.1h.js         Example: Beeper message digest agent
+    .env.beeper          Example env file for beeper agent
 ```
 
 ## Credits

package/SECURITY.md

@@ -0,0 +1,18 @@
+# Security Policy
+
+## Reporting a Vulnerability
+
+If you discover a security vulnerability in this project, please report it privately through GitHub Security Advisories:
+
+https://github.com/f/poke-gate/security/advisories/new
+
+Please do not disclose vulnerabilities publicly until maintainers have had a chance to investigate and patch.
+
+## What to Include
+
+1. A clear description of the issue.
+2. Reproduction steps or a proof of concept.
+3. The expected impact.
+4. Any suggested mitigation (optional).
+
+We will aim to acknowledge reports within 72 hours and provide updates as the investigation progresses.

package/bin/poke-gate.js

@@ -1,101 +1,29 @@
 #!/usr/bin/env node
 
-import { readFileSync, writeFileSync, mkdirSync } from "node:fs";
-import { join } from "node:path";
-import { homedir } from "node:os";
-import { createInterface } from "node:readline";
-
-const CONFIG_DIR = process.env.XDG_CONFIG_HOME || join(homedir(), ".config");
-const CONFIG_PATH = join(CONFIG_DIR, "poke-gate", "config.json");
-
-function loadConfig() {
-  try {
-    return JSON.parse(readFileSync(CONFIG_PATH, "utf-8"));
-  } catch {
-    return {};
-  }
-}
-
-function saveConfig(config) {
-  mkdirSync(join(CONFIG_DIR, "poke-gate"), { recursive: true });
-  writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2));
-}
-
-function loadPokeCredentials() {
-  try {
-    const creds = JSON.parse(readFileSync(join(CONFIG_DIR, "poke", "credentials.json"), "utf-8"));
-    if (creds.token) return creds.token;
-  } catch {}
-  return null;
-}
-
-function resolveToken() {
-  if (process.env.POKE_API_KEY) return process.env.POKE_API_KEY;
-  const config = loadConfig();
-  if (config.apiKey) return config.apiKey;
-  const pokeCreds = loadPokeCredentials();
-  if (pokeCreds) return pokeCreds;
-  return null;
-}
-
-function ask(question) {
-  const rl = createInterface({ input: process.stdin, output: process.stdout });
-  return new Promise((resolve) => {
-    rl.question(question, (answer) => {
-      rl.close();
-      resolve(answer.trim());
-    });
-  });
-}
-
-async function onboarding() {
-  console.log();
-  console.log("  poke-gate — expose your machine to Poke");
-  console.log();
-  console.log("  Your Poke agent will be able to run commands,");
-  console.log("  read/write files, and access system info on this machine.");
-  console.log();
-  console.log("  ⚠  This grants full shell access. Only run on trusted networks.");
-  console.log();
-  console.log("  To get started, either:");
-  console.log();
-  console.log("  Option 1: Run 'npx poke login' (recommended)");
-  console.log("  Option 2: Paste an API key from https://poke.com/kitchen/api-keys");
-  console.log();
-
-  const key = await ask("  API key (or press Enter if you ran poke login): ");
-
-  if (!key) {
-    const pokeCreds = loadPokeCredentials();
-    if (pokeCreds) {
-      console.log();
-      console.log("  Found poke login credentials! Starting...");
-      console.log();
-      return pokeCreds;
-    }
-    console.log();
-    console.log("  No credentials found. Run: npx poke login");
-    console.log();
-    process.exit(1);
-  }
-
-  saveConfig({ apiKey: key });
-  console.log();
-  console.log("  Saved! Starting poke-gate...");
-  console.log();
-
-  return key;
-}
+const args = process.argv.slice(2);
 
 async function main() {
-  let token = resolveToken();
-
-  if (!token) {
-    token = await onboarding();
+  if (args[0] === "run-agent") {
+    const name = args[1];
+    if (!name) {
+      console.error("Usage: poke-gate run-agent <name>");
+      console.error("Example: poke-gate run-agent beeper");
+      process.exit(1);
+    }
+    const { runAgent } = await import("../src/agents.js");
+    await runAgent(name);
+  } else if (args[0] === "agent" && args[1] === "get") {
+    const name = args[2];
+    if (!name) {
+      console.error("Usage: poke-gate agent get <name>");
+      console.error("Example: poke-gate agent get beeper");
+      process.exit(1);
+    }
+    const { downloadAgent } = await import("../src/agents.js");
+    await downloadAgent(name);
+  } else {
+    await import("../src/app.js");
   }
-
-  process.env.POKE_API_KEY = token;
-  await import("../src/app.js");
 }
 
 main();

package/clients/Poke macOS Gate/Poke macOS Gate/AboutView.swift

@@ -0,0 +1,54 @@
+import SwiftUI
+
+struct AboutView: View {
+    @Environment(\.dismiss) private var dismiss
+
+    var body: some View {
+        VStack(spacing: 16) {
+            Image(nsImage: NSApp.applicationIconImage)
+                .resizable()
+                .frame(width: 80, height: 80)
+
+            Text("Poke Gate")
+                .font(.title2)
+                .fontWeight(.semibold)
+
+            Text("Version 0.0.8")
+                .font(.caption)
+                .foregroundStyle(.secondary)
+
+            Text("Let your Poke AI assistant access your machine.\nRun commands, read files, take screenshots — from anywhere.")
+                .font(.caption)
+                .foregroundStyle(.secondary)
+                .multilineTextAlignment(.center)
+                .fixedSize(horizontal: false, vertical: true)
+
+            Divider()
+
+            VStack(spacing: 4) {
+                Text("A community project — not affiliated with Poke")
+                    .font(.caption2)
+                    .foregroundStyle(.tertiary)
+
+                Text("or The Interaction Company of California.")
+                    .font(.caption2)
+                    .foregroundStyle(.tertiary)
+            }
+
+            HStack(spacing: 16) {
+                Link("GitHub", destination: URL(string: "https://github.com/f/poke-gate")!)
+                    .font(.caption)
+
+                Link("poke.com", destination: URL(string: "https://poke.com")!)
+                    .font(.caption)
+            }
+
+            Button("Close") {
+                dismiss()
+            }
+            .keyboardShortcut(.cancelAction)
+        }
+        .padding(24)
+        .frame(width: 300)
+    }
+}

package/clients/Poke macOS Gate/Poke macOS Gate/GateService.swift

@@ -30,6 +30,16 @@ class GateService: ObservableObject {
         resolveToken() != nil
     }
 
+    func runPokeLogin() {
+        let fullPath = shellPath()
+        let proc = Process()
+        proc.executableURL = URL(fileURLWithPath: "/bin/zsh")
+        proc.arguments = ["-c", "npx -y poke@latest login"]
+        proc.environment = ["HOME": NSHomeDirectory(), "PATH": fullPath]
+        try? proc.run()
+        appendLog("Launched poke login — check your browser.")
+    }
+
     func autoStartIfNeeded() {
         guard !hasAutoStarted else { return }
         hasAutoStarted = true

package/clients/Poke macOS Gate/Poke macOS Gate/LogsView.swift

@@ -6,42 +6,76 @@ struct LogsView: View {
     var body: some View {
         VStack(spacing: 0) {
             HStack {
-                Text("Logs")
-                    .font(.headline)
+                Text("\(service.logs.count) entries")
+                    .font(.caption)
+                    .foregroundStyle(.tertiary)
+
                 Spacer()
-                Button("Clear") {
+
+                Button {
+                    let text = service.logs.joined(separator: "\n")
+                    NSPasteboard.general.clearContents()
+                    NSPasteboard.general.setString(text, forType: .string)
+                } label: {
+                    Image(systemName: "doc.on.doc")
+                        .font(.caption)
+                }
+                .buttonStyle(.plain)
+                .foregroundStyle(.secondary)
+                .help("Copy all logs")
+
+                Button {
                     service.logs.removeAll()
+                } label: {
+                    Image(systemName: "trash")
+                        .font(.caption)
                 }
                 .buttonStyle(.plain)
                 .foregroundStyle(.secondary)
-                .font(.caption)
+                .help("Clear logs")
             }
-            .padding(.horizontal, 12)
+            .padding(.horizontal, 16)
             .padding(.vertical, 8)
 
             Divider()
 
             ScrollViewReader { proxy in
                 ScrollView {
-                    LazyVStack(alignment: .leading, spacing: 2) {
+                    LazyVStack(alignment: .leading, spacing: 1) {
                         ForEach(Array(service.logs.enumerated()), id: \.offset) { index, line in
                             Text(line)
                                 .font(.system(.caption, design: .monospaced))
-                                .foregroundStyle(.primary)
+                                .foregroundStyle(lineColor(line))
                                 .textSelection(.enabled)
+                                .fixedSize(horizontal: false, vertical: true)
+                                .padding(.horizontal, 16)
+                                .padding(.vertical, 2)
+                                .frame(maxWidth: .infinity, alignment: .leading)
+                                .background(index % 2 == 0 ? Color.clear : Color.primary.opacity(0.02))
                                 .id(index)
                         }
                     }
-                    .padding(.horizontal, 12)
-                    .padding(.vertical, 8)
+                    .padding(.vertical, 4)
                 }
                 .onChange(of: service.logs.count) { _, _ in
                     if let last = service.logs.indices.last {
-                        proxy.scrollTo(last, anchor: .bottom)
+                        withAnimation(.easeOut(duration: 0.15)) {
+                            proxy.scrollTo(last, anchor: .bottom)
+                        }
                     }
                 }
             }
         }
-        .frame(width: 480, height: 320)
+        .frame(minWidth: 480, minHeight: 300)
+    }
+
+    private func lineColor(_ line: String) -> Color {
+        if line.contains("error") || line.contains("Error") || line.contains("failed") {
+            return .red
+        }
+        if line.contains("tool:") || line.contains("$") {
+            return .primary
+        }
+        return .secondary
     }
 }