freeturtle 0.1.14 → 0.1.16

package/README.md

@@ -2,15 +2,58 @@
 
 An open-source framework for deploying autonomous AI CEOs that run onchain businesses.
 
-## Quick Start
+## Getting Started
+
+### 1. Set Up a Server
+
+You need a Linux server that runs 24/7. We recommend [Oracle Cloud's free ARM instance](docs/oracle-cloud-setup.md) — 2 CPUs, 12 GB RAM, always free.
+
+> **New to servers?** The [Oracle Cloud setup guide](docs/oracle-cloud-setup.md) walks through everything from account creation to SSH. Paste it into an AI chat (ChatGPT, Claude, etc.) and ask it to guide you step by step.
+
+### 2. Create Accounts for Your CEO
+
+Before running init, create a separate identity for your CEO:
+
+- **Google account** — use it to sign up for everything below
+- **Farcaster** — the account your CEO will post from
+- **Neynar** — API access for Farcaster (sign up at [dev.neynar.com](https://dev.neynar.com))
+- **GitHub** (optional) — if your CEO will manage repos, give it its own account
+
+The CEO is effectively a team member who needs its own accounts.
+
+### 3. Install and Run
 
 ```bash
-pnpm install -g freeturtle
+# Install Node.js and pnpm (if not already installed)
+curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
+sudo apt-get install -y nodejs
+sudo npm install -g pnpm
+
+# Install FreeTurtle
+sudo pnpm install -g freeturtle
+
+# Set up your CEO (interactive wizard)
 freeturtle init
+
+# Start the daemon
 freeturtle start
+
+# Keep it running after reboot (Linux)
+freeturtle install-service
 ```
 
-The setup wizard walks you through everything: naming your AI CEO, connecting Farcaster, Telegram, GitHub, a database, and onchain data.
+The setup wizard walks you through naming your AI CEO, picking an LLM provider, connecting Farcaster, Telegram, GitHub, and more.
+
+### 4. Set Up Webhooks (optional)
+
+If you want your CEO to auto-respond to Farcaster mentions and replies, you need webhooks. This requires HTTPS, which means a domain and a reverse proxy.
+
+The quickest path:
+1. Get a free subdomain at [duckdns.org](https://www.duckdns.org)
+2. Install Caddy (`sudo apt install -y caddy`) — it handles HTTPS automatically
+3. Run `freeturtle webhooks` to register with Neynar
+
+See the [Oracle Cloud setup guide](docs/oracle-cloud-setup.md#setting-up-webhooks-farcaster-mentionsreplies) for full instructions.
 
 ## What It Does
 
@@ -35,7 +78,7 @@ FreeTurtle is a Node.js daemon that mostly sleeps and wakes up when:
 3. The **founder sends a message** via Terminal or Telegram
 4. A **webhook event** arrives (e.g. someone mentions the CEO on Farcaster)
 
-All three route to the same **task runner**, which:
+All four route to the same **task runner**, which:
 
 1. Loads `soul.md` (the CEO's identity and voice)
 2. Loads recent memory (posting log, post queue)
@@ -80,6 +123,24 @@ All three route to the same **task runner**, which:
 └──────────────────────────────────────────────────────┘
 ```
 
+## CLI Commands
+
+```bash
+freeturtle init              # Set up a new AI CEO
+freeturtle start             # Start the daemon
+freeturtle start --chat      # Start with interactive terminal chat
+freeturtle status            # Show daemon status
+freeturtle send "message"    # Send a message to the running CEO
+freeturtle setup             # Reconfigure LLM provider
+freeturtle connect farcaster # Set up Farcaster signer
+freeturtle webhooks          # Set up Neynar webhooks (mentions, replies, watched users/channels)
+freeturtle approvals         # List pending approval requests
+freeturtle approve <id>      # Approve a pending action
+freeturtle reject <id>       # Reject a pending action
+freeturtle update            # Update to the latest version
+freeturtle install-service   # Install as a systemd service (Linux)
+```
+
 ## Modules
 
 ### Workspace (always loaded)
@@ -156,7 +217,7 @@ Read smart contracts, balances, and transactions on Base.
 | `get_balance` | Get ETH balance of an address |
 | `get_transactions` | Get recent transactions (requires BaseScan key) |
 
-**Env:** `RPC_URL`, `BASESCAN_API_KEY` (optional)
+**Env:** `RPC_URL`, `BLOCK_EXPLORER_API_KEY` (optional)
 
 ## Configuration
 
@@ -189,7 +250,7 @@ Controls the daemon. Markdown format:
 ```markdown
 ## LLM
 - provider: claude_api
-- model: claude-sonnet-4-5-20250514
+- model: claude-sonnet-4-5
 - max_tokens: 4096
 
 ## Cron
@@ -236,46 +297,19 @@ DATABASE_URL=postgres://...
 RPC_URL=https://mainnet.base.org
 ```
 
-## CLI Commands
-
-```bash
-freeturtle init              # Set up a new AI CEO
-freeturtle start             # Start the daemon
-freeturtle start --chat      # Start with interactive terminal chat
-freeturtle status            # Show daemon status
-freeturtle send "message"    # Send a message to the running CEO
-freeturtle setup             # Reconfigure LLM provider
-freeturtle connect farcaster # Set up Farcaster signer
-freeturtle webhooks          # Set up Neynar webhooks (mentions, replies, watched users/channels)
-freeturtle approvals         # List pending approval requests
-freeturtle approve <id>      # Approve a pending action
-freeturtle reject <id>       # Reject a pending action
-freeturtle update            # Update to the latest version
-freeturtle install-service   # Install as a systemd service (Linux)
-```
-
-## Hosting
-
-We recommend [Oracle Cloud's free ARM instance](docs/oracle-cloud-setup.md) — 4 CPUs, 24 GB RAM, always free. The setup guide walks through account creation, instance setup, networking, and installing FreeTurtle as a system service.
-
-```bash
-# On your server
-pnpm install -g freeturtle
-freeturtle init
-freeturtle start
-freeturtle install-service  # auto-restart on reboot
-```
+## Self-Modification
 
-## Before You Begin
+FreeTurtle CEOs can modify their own behavior at runtime. Everything that defines the CEO — identity, voice, goals, config, memory — is a file in the workspace, and the CEO has tools to read and write those files.
 
-**Create a separate account for your CEO.** Start with a Google account, then use it to sign up for:
+Examples of what you can tell your CEO:
 
-- Farcaster (the account your CEO will post from)
-- Neynar (API access for Farcaster)
-- GitHub (if your CEO will manage repos)
-- Any other services your CEO needs
+- **"Be more direct and honest"** — CEO edits the Voice section of `soul.md` (requires your approval)
+- **"Remember that @rish posts interesting stuff"** — CEO writes a note to `workspace/memory/notes.md`
+- **"Change posting to every 4 hours"** — CEO edits the cron schedule in `config.md` (requires approval, takes effect on restart)
+- **"Add a goal about growing the Discord"** — CEO edits the Goals section of `soul.md` (requires approval)
+- **"Write a brief on this week's engagement"** — CEO writes to `workspace/strategy/`
 
-The CEO is effectively a team member who needs its own accounts. Identity separation keeps things clean.
+Changes to core files (`soul.md`, `config.md`, `.env`) always require founder approval. Memory and notes writes go through freely.
 
 ## Policy & Approvals
 
@@ -305,9 +339,9 @@ Add a `## Policy` section to `config.md`:
 ```
 
 **Allowlist rules:**
-- Not set → allow all (no restriction)
-- Empty list → deny everything
-- Populated list → only allow listed values
+- Not set — allow all (no restriction)
+- Empty list — deny everything
+- Populated list — only allow listed values
 
 ### Approval Flow
 
@@ -392,20 +426,6 @@ Your `.env` file contains API keys and tokens. FreeTurtle automatically sets it
 
 Your cloud provider (Oracle, AWS, GCP) has full access to the underlying infrastructure — they can technically read any file on your VM. This is true of all cloud computing and is covered by their terms of service. For most use cases this is fine. If this is unacceptable for your threat model, run FreeTurtle on hardware you physically control.
 
-## Self-Modification
-
-FreeTurtle CEOs can modify their own behavior at runtime. Everything that defines the CEO — identity, voice, goals, config, memory — is a file in the workspace, and the CEO has tools to read and write those files.
-
-Examples of what you can tell your CEO:
-
-- **"Be more direct and honest"** → CEO edits the Voice section of `soul.md` (requires your approval)
-- **"Remember that @rish posts interesting stuff"** → CEO writes a note to `workspace/memory/notes.md`
-- **"Change posting to every 4 hours"** → CEO edits the cron schedule in `config.md` (requires approval, takes effect on restart)
-- **"Add a goal about growing the Discord"** → CEO edits the Goals section of `soul.md` (requires approval)
-- **"Write a brief on this week's engagement"** → CEO writes to `workspace/strategy/`
-
-Changes to core files (`soul.md`, `config.md`, `.env`) always require founder approval. Memory and notes writes go through freely.
-
 ## The Two-Turtle Vision (v0.2)
 
 The current v0.1 is a single-process CEO. v0.2 will split it into two:

package/dist/bin/freeturtle.js

@@ -15,14 +15,14 @@ const program = new Command();
 program
     .name("freeturtle")
     .description("An open-source framework for deploying autonomous AI CEOs that run onchain businesses.")
-    .version("0.1.14");
+    .version("0.1.15");
 program
     .command("hello")
     .description("Verify the CLI is working")
     .action(() => {
     console.log("  \x1b[38;2;94;255;164m _____     ____\x1b[0m");
     console.log("  \x1b[38;2;94;255;164m/      \\  |  o |\x1b[0m");
-    console.log("  \x1b[38;2;94;255;164m|        |/ ___\\|\x1b[0m  FreeTurtle v0.1.14");
+    console.log("  \x1b[38;2;94;255;164m|        |/ ___\\|\x1b[0m  FreeTurtle v0.1.15");
     console.log("  \x1b[38;2;94;255;164m|_________/\x1b[0m");
     console.log("  \x1b[38;2;94;255;164m|_|_| |_|_|\x1b[0m");
 });
@@ -125,6 +125,14 @@ connect
     const { connectFarcaster } = await import("../src/cli/connect-farcaster.js");
     await connectFarcaster(opts.dir);
 });
+connect
+    .command("gmail")
+    .description("Connect Gmail for reading and sending emails")
+    .option("--dir <path>", "Workspace directory", DEFAULT_DIR)
+    .action(async (opts) => {
+    const { connectGmail } = await import("../src/cli/connect-gmail.js");
+    await connectGmail(opts.dir);
+});
 program
     .command("webhooks")
     .description("Set up Neynar webhooks for Farcaster mentions")

package/dist/bin/freeturtle.js.map

@@ -1 +1 @@
-{"version":3,"file":"freeturtle.js","sourceRoot":"","sources":["../../bin/freeturtle.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"freeturtle.js","sourceRoot":"","sources":["../../bin/freeturtle.ts"],"names":[],"mappings":";AAEA,mGAAmG;AACnG,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAwB,CAAC;AACnE,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC,KAAa,EAAE,GAAG,IAAe,EAAW,EAAE;IAC7D,IAAI,KAAK,KAAK,SAAS,IAAI,IAAI,CAAC,CAAC,CAAC,YAAY,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,oBAAoB,EAAE,CAAC;QAC7F,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,QAAQ,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC;AAClC,CAAC,CAAwB,CAAC;AAE1B,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,aAAa,CAAC,CAAC;AAEnD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,YAAY,CAAC;KAClB,WAAW,CACV,wFAAwF,CACzF;KACA,OAAO,CAAC,QAAQ,CAAC,CAAC;AAErB,OAAO;KACJ,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,2BAA2B,CAAC;KACxC,MAAM,CAAC,GAAG,EAAE;IACX,OAAO,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC;IAC7D,OAAO,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC;IAC/D,OAAO,CAAC,GAAG,CAAC,sEAAsE,CAAC,CAAC;IACpF,OAAO,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC;IACzD,OAAO,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC;AAC3D,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,qBAAqB,CAAC;KAClC,MAAM,CAAC,cAAc,EAAE,qBAAqB,EAAE,WAAW,CAAC;KAC1D,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;IACrB,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;IACvD,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC1B,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,yCAAyC,CAAC;KACtD,MAAM,CAAC,cAAc,EAAE,qBAAqB,EAAE,WAAW,CAAC;KAC1D,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;IACrB,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;IACrD,MAAM,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC3B,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,6BAA6B,CAAC;KAC1C,MAAM,CAAC,cAAc,EAAE,qBAAqB,EAAE,WAAW,CAAC;KAC1D,MAAM,CAAC,QAAQ,EAAE,gCAAgC,EAAE,KAAK,CAAC;KACzD,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;IACrB,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;IACzD,MAAM,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;AAChD,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,oBAAoB,CAAC;KACjC,MAAM,CAAC,cAAc,EAAE,qBAAqB,EAAE,WAAW,CAAC;KAC1D,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;IACrB,IAAI,CAAC;QACH,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;QAC3D,MAAM,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,KAAK;YAAE,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACrD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,gBAAgB,CAAC;KACzB,WAAW,CAAC,mCAAmC,CAAC;KAChD,MAAM,CAAC,cAAc,EAAE,qBAAqB,EAAE,WAAW,CAAC;KAC1D,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;IAC9B,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;IACvD,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;AACnC,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,yCAAyC,CAAC;KACtD,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;IAC3D,MAAM,SAAS,EAAE,CAAC;AACpB,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,iBAAiB,CAAC;KAC1B,WAAW,CAAC,sDAAsD,CAAC;KACnE,MAAM,CAAC,cAAc,EAAE,qBAAqB,EAAE,WAAW,CAAC;KAC1D,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;IACrB,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,+BAA+B,CAAC,CAAC;IAC5E,MAAM,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACpC,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,cAAc,CAAC;KACvB,WAAW,CAAC,0BAA0B,CAAC;KACvC,MAAM,CAAC,cAAc,EAAE,qBAAqB,EAAE,WAAW,CAAC;KAC1D,MAAM,CAAC,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE;IACzB,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAC;IAC/D,MAAM,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;AACjC,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,aAAa,CAAC;KACtB,WAAW,CAAC,yBAAyB,CAAC;KACtC,MAAM,CAAC,cAAc,EAAE,qBAAqB,EAAE,WAAW,CAAC;KAC1D,MAAM,CAAC,mBAAmB,EAAE,kBAAkB,CAAC;KAC/C,MAAM,CAAC,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE;IACzB,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAC;IAC9D,MAAM,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;AAC7C,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,WAAW,CAAC;KACpB,WAAW,CAAC,gCAAgC,CAAC;KAC7C,MAAM,CAAC,cAAc,EAAE,qBAAqB,EAAE,WAAW,CAAC;KAC1D,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;IACrB,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAC;IACrE,MAAM,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACnC,CAAC,CAAC,CAAC;AAEL,MAAM,OAAO,GAAG,OAAO;KACpB,OAAO,CAAC,SAAS,CAAC;KAClB,WAAW,CAAC,2BAA2B,CAAC,CAAC;AAE5C,OAAO;KACJ,OAAO,CAAC,WAAW,CAAC;KACpB,WAAW,CAAC,+CAA+C,CAAC;KAC5D,MAAM,CAAC,cAAc,EAAE,qBAAqB,EAAE,WAAW,CAAC;KAC1D,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;IACrB,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,iCAAiC,CAAC,CAAC;IAC7E,MAAM,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACnC,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,8CAA8C,CAAC;KAC3D,MAAM,CAAC,cAAc,EAAE,qBAAqB,EAAE,WAAW,CAAC;KAC1D,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;IACrB,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,6BAA6B,CAAC,CAAC;IACrE,MAAM,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/B,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,UAAU,CAAC;KACnB,WAAW,CAAC,+CAA+C,CAAC;KAC5D,MAAM,CAAC,cAAc,EAAE,qBAAqB,EAAE,WAAW,CAAC;KAC1D,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;IACrB,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC;IACpE,MAAM,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACnC,CAAC,CAAC,CAAC;AAEL,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/src/cli/connect-gmail.d.ts

@@ -0,0 +1,6 @@
+export interface GmailConnectResult {
+    clientId: string;
+    clientSecret: string;
+    email: string;
+}
+export declare function connectGmail(dir: string): Promise<GmailConnectResult | null>;

package/dist/src/cli/connect-gmail.js

@@ -0,0 +1,128 @@
+import * as p from "@clack/prompts";
+import { readFile, writeFile, chmod, mkdir } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { runGoogleOAuthFlow, createGoogleOAuth2Client, } from "../oauth/google.js";
+import { GmailClient } from "../modules/gmail/client.js";
+export async function connectGmail(dir) {
+    p.intro("Gmail Setup");
+    p.note([
+        "We recommend creating a dedicated Google account for your",
+        "CEO so emails come from its own identity. You can use this",
+        "same Google account to create a GitHub account for the CEO.",
+    ].join("\n"), "Recommendation");
+    const email = await p.text({
+        message: "Gmail address for the CEO",
+        placeholder: "ceo@gmail.com",
+        validate: (v) => {
+            if (!v?.trim())
+                return "Required";
+            if (!v.includes("@"))
+                return "Must be a valid email address";
+            return undefined;
+        },
+    });
+    if (p.isCancel(email)) {
+        p.cancel("Cancelled.");
+        return null;
+    }
+    p.note([
+        "To connect Gmail, you need a Google Cloud OAuth client:",
+        "",
+        "1. Go to console.cloud.google.com/apis/credentials",
+        "2. Create a project (or use an existing one)",
+        "3. Enable the Gmail API:",
+        "   APIs & Services > Library > search 'Gmail API' > Enable",
+        "4. Create OAuth 2.0 Client ID:",
+        "   Credentials > Create Credentials > OAuth client ID",
+        "   Application type: Desktop app",
+        "5. Copy the Client ID and Client Secret",
+        "",
+        "Tip: paste these instructions into an AI chat and ask it",
+        "to walk you through step by step.",
+    ].join("\n"), "Google Cloud Setup");
+    const clientId = await p.text({
+        message: "OAuth Client ID",
+        validate: (v) => (v?.trim() ? undefined : "Required"),
+    });
+    if (p.isCancel(clientId)) {
+        p.cancel("Cancelled.");
+        return null;
+    }
+    const clientSecret = await p.text({
+        message: "OAuth Client Secret",
+        validate: (v) => (v?.trim() ? undefined : "Required"),
+    });
+    if (p.isCancel(clientSecret)) {
+        p.cancel("Cancelled.");
+        return null;
+    }
+    p.note("A browser window will open for Gmail authorization.\nSign in with the CEO's Google account and grant access.", "OAuth Flow");
+    const s = p.spinner();
+    s.start("Waiting for browser authorization...");
+    let refreshToken;
+    try {
+        refreshToken = await runGoogleOAuthFlow(clientId.trim(), clientSecret.trim());
+        s.stop("Authorization successful!");
+    }
+    catch (err) {
+        s.stop("Authorization failed");
+        p.log.error(`OAuth failed: ${err instanceof Error ? err.message : "Unknown error"}`);
+        return null;
+    }
+    // Test connection
+    s.start("Testing Gmail connection...");
+    try {
+        const auth = createGoogleOAuth2Client({
+            clientId: clientId.trim(),
+            clientSecret: clientSecret.trim(),
+            refreshToken,
+        });
+        const client = new GmailClient(auth);
+        const sendAs = await client.getSendAs();
+        const primary = sendAs.find((a) => a.isPrimary) || sendAs[0];
+        const displayName = primary?.displayName;
+        s.stop(displayName
+            ? `Connected as ${displayName} (${primary?.email})`
+            : `Connected as ${primary?.email || email}`);
+    }
+    catch (err) {
+        s.stop("Connection test failed");
+        p.log.warn(`Could not verify Gmail access: ${err instanceof Error ? err.message : "Unknown error"}`);
+        p.log.warn("The credentials were saved — you can test later with: freeturtle status");
+    }
+    // Save to .env
+    const envPath = join(dir, ".env");
+    let envContent = "";
+    try {
+        envContent = await readFile(envPath, "utf-8");
+    }
+    catch {
+        // No existing .env
+    }
+    const envVars = {
+        GOOGLE_CLIENT_ID: clientId.trim(),
+        GOOGLE_CLIENT_SECRET: clientSecret.trim(),
+        GOOGLE_GMAIL_REFRESH_TOKEN: refreshToken,
+    };
+    for (const [key, value] of Object.entries(envVars)) {
+        const regex = new RegExp(`^${key}=.*$`, "m");
+        if (regex.test(envContent)) {
+            envContent = envContent.replace(regex, `${key}=${value}`);
+        }
+        else {
+            envContent +=
+                `${envContent.endsWith("\n") || envContent === "" ? "" : "\n"}${key}=${value}\n`;
+        }
+    }
+    await mkdir(dirname(envPath), { recursive: true });
+    await writeFile(envPath, envContent, "utf-8");
+    await chmod(envPath, 0o600);
+    p.log.success("Gmail credentials saved to .env");
+    p.outro("Gmail connected!");
+    return {
+        clientId: clientId.trim(),
+        clientSecret: clientSecret.trim(),
+        email: email.trim(),
+    };
+}
+//# sourceMappingURL=connect-gmail.js.map

package/dist/src/cli/connect-gmail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect-gmail.js","sourceRoot":"","sources":["../../../src/cli/connect-gmail.ts"],"names":[],"mappings":"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"}

package/dist/src/cli/connection-tests.d.ts

@@ -10,6 +10,10 @@ export declare function testGitHub(token: string): Promise<void>;
  * Test a Postgres connection URL by connecting and immediately disconnecting.
  */
 export declare function testDatabase(url: string): Promise<void>;
+/**
+ * Test Gmail OAuth credentials by calling the profile endpoint.
+ */
+export declare function testGmail(clientId: string, clientSecret: string, refreshToken: string): Promise<void>;
 /**
  * Test an EVM RPC URL by calling eth_blockNumber.
  */

package/dist/src/cli/connection-tests.js

@@ -40,6 +40,16 @@ export async function testDatabase(url) {
         await client.end().catch(() => { });
     }
 }
+/**
+ * Test Gmail OAuth credentials by calling the profile endpoint.
+ */
+export async function testGmail(clientId, clientSecret, refreshToken) {
+    const { createGoogleOAuth2Client } = await import("../oauth/google.js");
+    const { GmailClient } = await import("../modules/gmail/client.js");
+    const auth = createGoogleOAuth2Client({ clientId, clientSecret, refreshToken });
+    const client = new GmailClient(auth);
+    await client.getProfile();
+}
 /**
  * Test an EVM RPC URL by calling eth_blockNumber.
  */

package/dist/src/cli/connection-tests.js.map

@@ -1 +1 @@
-{"version":3,"file":"connection-tests.js","sourceRoot":"","sources":["../../../src/cli/connection-tests.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AAEpB;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,KAAa;IAC9C,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,+BAA+B,KAAK,QAAQ,CAAC,CAAC;IACtE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,uBAAuB,GAAG,CAAC,MAAM,MAAM,IAAI,EAAE,CAAC,CAAC;IACjE,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA0C,CAAC;IACzE,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,4BAA4B,IAAI,CAAC,WAAW,IAAI,SAAS,EAAE,CAAC,CAAC;IAC/E,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,KAAa;IAC5C,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,6BAA6B,EAAE;QACrD,OAAO,EAAE;YACP,aAAa,EAAE,UAAU,KAAK,EAAE;YAChC,MAAM,EAAE,6BAA6B;SACtC;KACF,CAAC,CAAC;IACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,CAAC,MAAM,MAAM,IAAI,EAAE,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAW;IAC5C,MAAM,MAAM,GAAG,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,gBAAgB,EAAE,GAAG,EAAE,CAAC,CAAC;IACxD,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;IACzB,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACrC,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAc;IAC9C,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,MAAM,EAAE;QAC9B,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YACnB,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,iBAAiB;YACzB,MAAM,EAAE,EAAE;YACV,EAAE,EAAE,CAAC;SACN,CAAC;KACH,CAAC,CAAC;IACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,cAAc,GAAG,CAAC,MAAM,MAAM,MAAM,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACpE,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAoC,CAAC;IACnE,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,cAAc,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACtD,CAAC;AACH,CAAC"}
+{"version":3,"file":"connection-tests.js","sourceRoot":"","sources":["../../../src/cli/connection-tests.ts"],"names":[],"mappings":"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"}

package/dist/src/cli/init.js

@@ -5,6 +5,7 @@ import { createInterface } from "node:readline";
 import { runSetup } from "../setup.js";
 import { LLMClient } from "../llm.js";
 import { connectFarcaster } from "./connect-farcaster.js";
+import { connectGmail } from "./connect-gmail.js";
 import { scanForSecrets, redactSecrets, condenseDocs } from "./intake.js";
 import { testTelegram, testGitHub, testDatabase, testOnchain } from "./connection-tests.js";
 import { createWebhook, channelToUrl } from "../webhooks/neynar.js";
@@ -15,7 +16,7 @@ const TURTLE = `
       \x1b[38;2;94;255;164m|_________/\x1b[0m
       \x1b[38;2;94;255;164m|_|_| |_|_|\x1b[0m
 
-      \x1b[1mFreeTurtle\x1b[0m  \x1b[2mv0.1.14\x1b[0m
+      \x1b[1mFreeTurtle\x1b[0m  \x1b[2mv0.1.15\x1b[0m
 `;
 const HATCH_FRAMES = [
     "  🥚",
@@ -172,6 +173,11 @@ export async function runInit(dir) {
         telegram: false,
         telegramToken: "",
         telegramOwner: "",
+        gmail: false,
+        googleClientId: "",
+        googleClientSecret: "",
+        googleRefreshToken: "",
+        gmailEmail: "",
         github: false,
         githubToken: "",
         database: false,
@@ -379,6 +385,9 @@ export async function runInit(dir) {
                 "  sudo systemctl restart caddy",
                 "",
                 "Your webhook URL will be: https://yourname.duckdns.org/webhook",
+                "",
+                "Tip: paste these instructions into an AI chat (ChatGPT, Claude,",
+                "etc.) and ask it to walk you through step by step.",
             ].join("\n"), "Webhooks");
             const enable = await p.confirm({
                 message: "Set up webhooks?",
@@ -546,7 +555,37 @@ export async function runInit(dir) {
             }
             return true;
         },
-        // 9. GitHub
+        // Gmail
+        async () => {
+            const enable = await p.confirm({
+                message: "Connect Gmail? (read and send emails)",
+                initialValue: state.gmail,
+            });
+            if (p.isCancel(enable))
+                return false;
+            state.gmail = enable;
+            if (enable) {
+                const result = await connectGmail(dir);
+                if (result) {
+                    state.googleClientId = result.clientId;
+                    state.googleClientSecret = result.clientSecret;
+                    state.gmailEmail = result.email;
+                    // Read the refresh token that connectGmail saved to .env
+                    try {
+                        const envContent = await readFile(join(dir, ".env"), "utf-8");
+                        const match = envContent.match(/^GOOGLE_GMAIL_REFRESH_TOKEN=(.+)$/m);
+                        if (match)
+                            state.googleRefreshToken = match[1];
+                    }
+                    catch { /* ignore */ }
+                }
+                else {
+                    state.gmail = false;
+                }
+            }
+            return true;
+        },
+        // GitHub
         async () => {
             const enable = await p.confirm({
                 message: "Connect GitHub? (issues and file commits)",
@@ -768,6 +807,7 @@ export async function runInit(dir) {
     const modules = [
         state.farcaster && "Farcaster",
         state.telegram && "Telegram",
+        state.gmail && "Gmail",
         state.github && "GitHub",
         state.database && "Database",
         state.onchain && "Onchain",
@@ -861,6 +901,9 @@ ${state.founderName}.
                     "### database",
                     `- enabled: ${state.database}`,
                     "",
+                    "### gmail",
+                    `- enabled: ${state.gmail}`,
+                    "",
                     "### github",
                     `- enabled: ${state.github}`,
                     "",
@@ -895,6 +938,12 @@ ${state.founderName}.
                     envLines.push(`TELEGRAM_BOT_TOKEN=${state.telegramToken}`);
                 if (state.telegramOwner)
                     envLines.push(`TELEGRAM_OWNER_ID=${state.telegramOwner}`);
+                if (state.googleClientId)
+                    envLines.push(`GOOGLE_CLIENT_ID=${state.googleClientId}`);
+                if (state.googleClientSecret)
+                    envLines.push(`GOOGLE_CLIENT_SECRET=${state.googleClientSecret}`);
+                if (state.googleRefreshToken)
+                    envLines.push(`GOOGLE_GMAIL_REFRESH_TOKEN=${state.googleRefreshToken}`);
                 if (state.githubToken)
                     envLines.push(`GITHUB_TOKEN=${state.githubToken}`);
                 if (state.dbUrl)