@termix-it/cryptoclaw 1.0.0

package/package.json

@@ -0,0 +1,242 @@
+{
+  "name": "@termix-it/cryptoclaw",
+  "version": "1.0.0",
+  "description": "Private crypto AI assistant — wallet management, DeFi, NFTs, and multi-chain operations from your terminal",
+  "keywords": [],
+  "license": "MIT",
+  "author": "",
+  "bin": {
+    "cryptoclaw": "cryptoclaw.mjs"
+  },
+  "files": [
+    "assets/",
+    "CHANGELOG.md",
+    "dist/",
+    "docs/",
+    "extensions/",
+    "LICENSE",
+    "cryptoclaw.mjs",
+    "README-header.png",
+    "README.md",
+    "skills/"
+  ],
+  "type": "module",
+  "main": "dist/index.js",
+  "exports": {
+    ".": "./dist/index.js",
+    "./plugin-sdk": "./dist/plugin-sdk/index.js",
+    "./cli-entry": "./cryptoclaw.mjs"
+  },
+  "scripts": {
+    "android:assemble": "cd apps/android && ./gradlew :app:assembleDebug",
+    "android:install": "cd apps/android && ./gradlew :app:installDebug",
+    "android:run": "cd apps/android && ./gradlew :app:installDebug && adb shell am start -n ai.openclaw.android/.MainActivity",
+    "android:test": "cd apps/android && ./gradlew :app:testDebugUnitTest",
+    "build": "pnpm canvas:a2ui:bundle && tsdown && node --import tsx scripts/canvas-a2ui-copy.ts && node --import tsx scripts/copy-hook-metadata.ts && node --import tsx scripts/write-build-info.ts && node --import tsx scripts/write-cli-compat.ts",
+    "canvas:a2ui:bundle": "bash scripts/bundle-a2ui.sh",
+    "check": "pnpm tsgo && pnpm lint && pnpm format",
+    "check:loc": "node --import tsx scripts/check-ts-max-loc.ts --max 500",
+    "cryptoclaw": "node scripts/run-node.mjs",
+    "cryptoclaw:rpc": "node scripts/run-node.mjs agent --mode rpc --json",
+    "dev": "node scripts/run-node.mjs",
+    "docs:bin": "node scripts/build-docs-list.mjs",
+    "docs:build": "cd docs && pnpm dlx --reporter append-only mint broken-links",
+    "docs:dev": "cd docs && mint dev",
+    "docs:list": "node scripts/docs-list.js",
+    "format": "oxfmt --check",
+    "format:all": "pnpm format && pnpm format:swift",
+    "format:fix": "oxfmt --write",
+    "format:swift": "swiftformat --lint --config .swiftformat apps/macos/Sources apps/ios/Sources apps/shared/OpenClawKit/Sources",
+    "gateway:dev": "CRYPTOCLAW_SKIP_CHANNELS=1 node scripts/run-node.mjs --dev gateway",
+    "gateway:dev:reset": "CRYPTOCLAW_SKIP_CHANNELS=1 node scripts/run-node.mjs --dev gateway --reset",
+    "gateway:watch": "node scripts/watch-node.mjs gateway --force",
+    "ios:build": "bash -lc 'cd apps/ios && xcodegen generate && xcodebuild -project OpenClaw.xcodeproj -scheme OpenClaw -destination \"${IOS_DEST:-platform=iOS Simulator,name=iPhone 17}\" -configuration Debug build'",
+    "ios:gen": "cd apps/ios && xcodegen generate",
+    "ios:open": "cd apps/ios && xcodegen generate && open OpenClaw.xcodeproj",
+    "ios:run": "bash -lc 'cd apps/ios && xcodegen generate && xcodebuild -project OpenClaw.xcodeproj -scheme OpenClaw -destination \"${IOS_DEST:-platform=iOS Simulator,name=iPhone 17}\" -configuration Debug build && xcrun simctl boot \"${IOS_SIM:-iPhone 17}\" || true && xcrun simctl launch booted ai.openclaw.ios'",
+    "lint": "oxlint --type-aware",
+    "lint:all": "pnpm lint && pnpm lint:swift",
+    "lint:fix": "oxlint --type-aware --fix && pnpm format:fix",
+    "lint:swift": "swiftlint lint --config .swiftlint.yml && (cd apps/ios && swiftlint lint --config .swiftlint.yml)",
+    "mac:open": "open dist/OpenClaw.app",
+    "mac:package": "bash scripts/package-mac-app.sh",
+    "mac:restart": "bash scripts/restart-mac.sh",
+    "moltbot:rpc": "node scripts/run-node.mjs agent --mode rpc --json",
+    "plugins:sync": "node --import tsx scripts/sync-plugin-versions.ts",
+    "prepack": "pnpm build && pnpm ui:build",
+    "prepare": "command -v git >/dev/null 2>&1 && git config core.hooksPath git-hooks || exit 0",
+    "protocol:check": "pnpm protocol:gen && pnpm protocol:gen:swift && git diff --exit-code -- dist/protocol.schema.json apps/macos/Sources/OpenClawProtocol/GatewayModels.swift",
+    "protocol:gen": "node --import tsx scripts/protocol-gen.ts",
+    "protocol:gen:swift": "node --import tsx scripts/protocol-gen-swift.ts",
+    "release:check": "node --import tsx scripts/release-check.ts",
+    "start": "node scripts/run-node.mjs",
+    "test": "node scripts/test-parallel.mjs",
+    "test:all": "pnpm lint && pnpm build && pnpm test && pnpm test:e2e && pnpm test:live && pnpm test:docker:all",
+    "test:coverage": "vitest run --coverage",
+    "test:docker:all": "pnpm test:docker:live-models && pnpm test:docker:live-gateway && pnpm test:docker:onboard && pnpm test:docker:gateway-network && pnpm test:docker:qr && pnpm test:docker:doctor-switch && pnpm test:docker:plugins && pnpm test:docker:cleanup",
+    "test:docker:cleanup": "bash scripts/test-cleanup-docker.sh",
+    "test:docker:doctor-switch": "bash scripts/e2e/doctor-install-switch-docker.sh",
+    "test:docker:gateway-network": "bash scripts/e2e/gateway-network-docker.sh",
+    "test:docker:live-gateway": "bash scripts/test-live-gateway-models-docker.sh",
+    "test:docker:live-models": "bash scripts/test-live-models-docker.sh",
+    "test:docker:onboard": "bash scripts/e2e/onboard-docker.sh",
+    "test:docker:plugins": "bash scripts/e2e/plugins-docker.sh",
+    "test:docker:qr": "bash scripts/e2e/qr-import-docker.sh",
+    "test:e2e": "vitest run --config vitest.e2e.config.ts",
+    "test:force": "node --import tsx scripts/test-force.ts",
+    "test:install:e2e": "bash scripts/test-install-sh-e2e-docker.sh",
+    "test:install:e2e:anthropic": "CRYPTOCLAW_E2E_MODELS=anthropic bash scripts/test-install-sh-e2e-docker.sh",
+    "test:install:e2e:openai": "CRYPTOCLAW_E2E_MODELS=openai bash scripts/test-install-sh-e2e-docker.sh",
+    "test:install:smoke": "bash scripts/test-install-sh-docker.sh",
+    "test:live": "CRYPTOCLAW_LIVE_TEST=1 vitest run --config vitest.live.config.ts",
+    "test:ui": "pnpm --dir ui test",
+    "test:watch": "vitest",
+    "tui": "node scripts/run-node.mjs tui",
+    "tui:dev": "CRYPTOCLAW_PROFILE=dev node scripts/run-node.mjs --dev tui",
+    "ui:build": "node scripts/ui.js build",
+    "ui:dev": "node scripts/ui.js dev",
+    "ui:install": "node scripts/ui.js install"
+  },
+  "dependencies": {
+    "@agentclientprotocol/sdk": "0.14.1",
+    "@aws-sdk/client-bedrock": "^3.984.0",
+    "@buape/carbon": "0.14.0",
+    "@clack/prompts": "^1.0.0",
+    "@grammyjs/runner": "^2.0.3",
+    "@grammyjs/transformer-throttler": "^1.2.1",
+    "@homebridge/ciao": "^1.3.4",
+    "@lydell/node-pty": "1.2.0-beta.3",
+    "@mariozechner/pi-agent-core": "0.52.6",
+    "@mariozechner/pi-ai": "0.52.6",
+    "@mariozechner/pi-coding-agent": "0.52.6",
+    "@mariozechner/pi-tui": "0.52.6",
+    "@mozilla/readability": "^0.6.0",
+    "@sinclair/typebox": "0.34.48",
+    "@slack/bolt": "^4.6.0",
+    "@slack/web-api": "^7.13.0",
+    "@whiskeysockets/baileys": "7.0.0-rc.9",
+    "ajv": "^8.17.1",
+    "chalk": "^5.6.2",
+    "chokidar": "^5.0.0",
+    "cli-highlight": "^2.1.11",
+    "commander": "^14.0.3",
+    "croner": "^10.0.1",
+    "discord-api-types": "^0.38.38",
+    "dotenv": "^17.2.4",
+    "express": "^5.2.1",
+    "file-type": "^21.3.0",
+    "grammy": "^1.39.3",
+    "hono": "4.11.7",
+    "jiti": "^2.6.1",
+    "json5": "^2.2.3",
+    "jszip": "^3.10.1",
+    "linkedom": "^0.18.12",
+    "long": "^5.3.2",
+    "markdown-it": "^14.1.0",
+    "node-edge-tts": "^1.2.10",
+    "osc-progress": "^0.3.0",
+    "pdfjs-dist": "^5.4.624",
+    "playwright-core": "1.58.1",
+    "proper-lockfile": "^4.1.2",
+    "qrcode-terminal": "^0.12.0",
+    "sharp": "^0.34.5",
+    "signal-utils": "^0.21.1",
+    "sqlite-vec": "0.1.7-alpha.2",
+    "tar": "7.5.7",
+    "tslog": "^4.10.2",
+    "undici": "^7.20.0",
+    "viem": "^2.27.2",
+    "ws": "^8.19.0",
+    "yaml": "^2.8.2",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@grammyjs/types": "^3.23.0",
+    "@lit-labs/signals": "^0.2.0",
+    "@lit/context": "^1.1.6",
+    "@types/express": "^5.0.6",
+    "@types/markdown-it": "^14.1.2",
+    "@types/node": "^25.2.1",
+    "@types/proper-lockfile": "^4.1.4",
+    "@types/qrcode-terminal": "^0.12.2",
+    "@types/ws": "^8.18.1",
+    "@typescript/native-preview": "7.0.0-dev.20260205.1",
+    "@vitest/coverage-v8": "^4.0.18",
+    "lit": "^3.3.2",
+    "ollama": "^0.6.3",
+    "oxfmt": "0.28.0",
+    "oxlint": "^1.43.0",
+    "oxlint-tsgolint": "^0.11.4",
+    "rolldown": "1.0.0-rc.3",
+    "tsdown": "^0.20.3",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  },
+  "peerDependencies": {
+    "@napi-rs/canvas": "^0.1.89",
+    "node-llama-cpp": "3.15.1"
+  },
+  "overrides": {
+    "tar": "7.5.7"
+  },
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "packageManager": "pnpm@10.23.0",
+  "pnpm": {
+    "minimumReleaseAge": 2880,
+    "overrides": {
+      "fast-xml-parser": "5.3.4",
+      "form-data": "2.5.4",
+      "@hono/node-server>hono": "4.11.7",
+      "hono": "4.11.7",
+      "qs": "6.14.1",
+      "@sinclair/typebox": "0.34.47",
+      "tar": "7.5.7",
+      "tough-cookie": "4.1.3"
+    },
+    "onlyBuiltDependencies": [
+      "@lydell/node-pty",
+      "@napi-rs/canvas",
+      "@whiskeysockets/baileys",
+      "authenticate-pam",
+      "esbuild",
+      "node-llama-cpp",
+      "protobufjs",
+      "sharp"
+    ]
+  },
+  "vitest": {
+    "coverage": {
+      "provider": "v8",
+      "reporter": [
+        "text",
+        "lcov"
+      ],
+      "thresholds": {
+        "lines": 70,
+        "functions": 70,
+        "branches": 70,
+        "statements": 70
+      },
+      "include": [
+        "src/**/*.ts"
+      ],
+      "exclude": [
+        "src/**/*.test.ts"
+      ]
+    },
+    "include": [
+      "src/**/*.test.ts"
+    ],
+    "exclude": [
+      "dist/**",
+      "apps/macos/**",
+      "apps/macos/.build/**",
+      "**/vendor/**",
+      "apps/macos/.build/**",
+      "dist/OpenClaw.app/**"
+    ]
+  }
+}

package/skills/aave-bsc/SKILL.md

@@ -0,0 +1,55 @@
+# AAVE V3 BSC SKILL
+
+This skill allows CryptoClaw to interact with the Aave V3 protocol on the BNB Smart Chain (BSC).
+
+## Protocol Addresses (BSC)
+
+- **Pool Proxy:** `0x6807dc923806fE8Fd134338EABCA509979a7e0cB`
+- **Pool Addresses Provider:** `0xff75B6da14FfbbfD355Daf7a2731456b3562Ba6D`
+- **Protocol Data Provider:** `0xc90Df74A7c16245c5F5C5870327Ceb38Fe5d5328`
+
+## Common Functions
+
+### getUserAccountData
+
+Query the user's current account state (collateral, debt, health factor).
+
+- **Contract:** Pool Proxy (`0x6807dc923806fE8Fd134338EABCA509979a7e0cB`)
+- **ABI Snippet:** `[{"inputs":[{"internalType":"address","name":"user","type":"address"}],"name":"getUserAccountData","outputs":[{"internalType":"uint256","name":"totalCollateralBase","type":"uint256"},{"internalType":"uint256","name":"totalDebtBase","type":"uint256"},{"internalType":"uint256","name":"availableBorrowsBase","type":"uint256"},{"internalType":"uint256","name":"currentLiquidationThreshold","type":"uint256"},{"internalType":"uint256","name":"ltv","type":"uint256"},{"internalType":"uint256","name":"healthFactor","type":"uint256"}],"stateMutability":"view","type":"function"}]`
+
+### supply
+
+Supply an asset as collateral.
+
+- **Contract:** Pool Proxy (`0x6807dc923806fE8Fd134338EABCA509979a7e0cB`)
+- **ABI Snippet:** `[{"inputs":[{"internalType":"address","name":"asset","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"},{"internalType":"address","name":"onBehalfOf","type":"address"},{"internalType":"uint16","name":"referralCode","type":"uint16"}],"name":"supply","outputs":[],"stateMutability":"nonpayable","type":"function"}]`
+- **Note:** Requires `approve` on the asset contract first.
+
+### withdraw
+
+Withdraw supplied collateral.
+
+- **Contract:** Pool Proxy (`0x6807dc923806fE8Fd134338EABCA509979a7e0cB`)
+- **ABI Snippet:** `[{"inputs":[{"internalType":"address","name":"asset","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"},{"internalType":"address","name":"to","type":"address"}],"name":"withdraw","outputs":[{"internalType":"uint256","name":"amountWithdrawn","type":"uint256"}],"stateMutability":"nonpayable","type":"function"}]`
+
+### borrow
+
+Borrow an asset against collateral.
+
+- **Contract:** Pool Proxy (`0x6807dc923806fE8Fd134338EABCA509979a7e0cB`)
+- **ABI Snippet:** `[{"inputs":[{"internalType":"address","name":"asset","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"},{"internalType":"uint256","name":"interestRateMode","type":"uint256"},{"internalType":"uint16","name":"referralCode","type":"uint16"},{"internalType":"address","name":"onBehalfOf","type":"address"}],"name":"borrow","outputs":[],"stateMutability":"nonpayable","type":"function"}]`
+- **InterestRateMode:** 2 (Variable) is standard.
+
+## Asset Addresses (BSC Underlying)
+
+- **WBNB:** `0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c`
+- **USDT:** `0x55d398326f99059fF775485246999027B3197955`
+- **USDC:** `0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d`
+- **BTCB:** `0x7130d2A12B9BCbFAe4f2634d864A1Ee1Ce3Ead9c`
+- **ETH:** `0x2170Ed0880ac9A755fd29B2688956BD959F933F8`
+
+## Usage Instructions
+
+1. Check user account data before suggesting borrow/withdraw.
+2. Always calculate gas estimates before write operations.
+3. For supply, ensure token approval is granted.

package/skills/agent-identity/SKILL.md

@@ -0,0 +1,48 @@
+---
+name: agent-identity
+description: Register and manage on-chain AI agent identity via ERC-8004.
+metadata: { "cryptoclaw": { "emoji": "🤖", "always": true } }
+---
+
+# Agent Identity Skill (ERC-8004)
+
+Register and manage your AI agent's on-chain identity using the ERC-8004 Trustless Agents standard.
+
+## Overview
+
+ERC-8004 gives AI agents verifiable on-chain identity via ERC-721 NFTs. Each agent gets a unique token ID, a metadata URI, a designated wallet, and a reputation score — all stored on-chain.
+
+## Tools
+
+- `agent_register` — Register this agent on-chain (mints NFT identity)
+- `agent_identity` — Query agent identity by ID (owner, URI, wallet)
+- `agent_set_wallet` — Set the agent's designated wallet (EIP-712 signed)
+- `agent_reputation` — Query reputation summary (feedback count + average score)
+- `agent_list_registered` — List all agent IDs owned by the active wallet
+
+## Workflow
+
+1. **Create a wallet** (if you don't have one): `cryptoclaw wallet create`
+2. **Register your agent**: "Register my agent on BSC with URI https://example.com/agent.json"
+3. **Check identity**: "What's my agent identity?"
+4. **Set agent wallet**: "Set my agent wallet to 0x..."
+5. **Check reputation**: "What's my agent's reputation?"
+
+## Supported Networks
+
+**Mainnet:** Ethereum, BSC, Base, Polygon, Arbitrum, Gnosis, Celo, Scroll, Taiko, Monad
+**Testnet:** Sepolia, BSC Testnet, Base Sepolia, Polygon Amoy, Arbitrum Sepolia, Celo Alfajores, Scroll Sepolia, Monad Testnet
+
+## Contract Addresses
+
+| Network | Identity Registry                            | Reputation Registry                          |
+| ------- | -------------------------------------------- | -------------------------------------------- |
+| Mainnet | `0x8004A169FB4a3325136EB29fA0ceB6D2e539a432` | `0x8004BAa17C55a88189AE136b182e5fdA19dE9b63` |
+| Testnet | `0x8004A818BFB912233c491871b3d84c89A494BD9e` | `0x8004B663056A597Dffe9eCcC1965A193B7388713` |
+
+## Security
+
+- `agent_register` and `agent_set_wallet` are state-changing and require confirmation
+- The agent's identity wallet is separate from the user's spending wallet
+- Private keys are never exposed in tool results or chat messages
+- Registration requires gas on the target network

package/skills/bird/SKILL.md

@@ -0,0 +1,224 @@
+---
+name: bird
+description: X/Twitter CLI for reading, searching, posting, and engagement via cookies.
+homepage: https://bird.fast
+metadata:
+  {
+    "cryptoclaw":
+      {
+        "emoji": "🐦",
+        "requires": { "bins": ["bird"] },
+        "install":
+          [
+            {
+              "id": "brew",
+              "kind": "brew",
+              "formula": "steipete/tap/bird",
+              "bins": ["bird"],
+              "label": "Install bird (brew)",
+              "os": ["darwin"],
+            },
+            {
+              "id": "npm",
+              "kind": "node",
+              "package": "@steipete/bird",
+              "bins": ["bird"],
+              "label": "Install bird (npm)",
+            },
+          ],
+      },
+  }
+---
+
+# bird 🐦
+
+Fast X/Twitter CLI using GraphQL + cookie auth.
+
+## Install
+
+```bash
+# npm/pnpm/bun
+npm install -g @steipete/bird
+
+# Homebrew (macOS, prebuilt binary)
+brew install steipete/tap/bird
+
+# One-shot (no install)
+bunx @steipete/bird whoami
+```
+
+## Authentication
+
+`bird` uses cookie-based auth.
+
+Use `--auth-token` / `--ct0` to pass cookies directly, or `--cookie-source` for browser cookies.
+
+Run `bird check` to see which source is active. For Arc/Brave, use `--chrome-profile-dir <path>`.
+
+## Commands
+
+### Account & Auth
+
+```bash
+bird whoami                    # Show logged-in account
+bird check                     # Show credential sources
+bird query-ids --fresh         # Refresh GraphQL query ID cache
+```
+
+### Reading Tweets
+
+```bash
+bird read <url-or-id>          # Read a single tweet
+bird <url-or-id>               # Shorthand for read
+bird thread <url-or-id>        # Full conversation thread
+bird replies <url-or-id>       # List replies to a tweet
+```
+
+### Timelines
+
+```bash
+bird home                      # Home timeline (For You)
+bird home --following          # Following timeline
+bird user-tweets @handle -n 20 # User's profile timeline
+bird mentions                  # Tweets mentioning you
+bird mentions --user @handle   # Mentions of another user
+```
+
+### Search
+
+```bash
+bird search "query" -n 10
+bird search "from:steipete" --all --max-pages 3
+```
+
+### News & Trending
+
+```bash
+bird news -n 10                # AI-curated from Explore tabs
+bird news --ai-only            # Filter to AI-curated only
+bird news --sports             # Sports tab
+bird news --with-tweets        # Include related tweets
+bird trending                  # Alias for news
+```
+
+### Lists
+
+```bash
+bird lists                     # Your lists
+bird lists --member-of         # Lists you're a member of
+bird list-timeline <id> -n 20  # Tweets from a list
+```
+
+### Bookmarks & Likes
+
+```bash
+bird bookmarks -n 10
+bird bookmarks --folder-id <id>           # Specific folder
+bird bookmarks --include-parent           # Include parent tweet
+bird bookmarks --author-chain             # Author's self-reply chain
+bird bookmarks --full-chain-only          # Full reply chain
+bird unbookmark <url-or-id>
+bird likes -n 10
+```
+
+### Social Graph
+
+```bash
+bird following -n 20           # Users you follow
+bird followers -n 20           # Users following you
+bird following --user <id>     # Another user's following
+bird about @handle             # Account origin/location info
+```
+
+### Engagement Actions
+
+```bash
+bird follow @handle            # Follow a user
+bird unfollow @handle          # Unfollow a user
+```
+
+### Posting
+
+```bash
+bird tweet "hello world"
+bird reply <url-or-id> "nice thread!"
+bird tweet "check this out" --media image.png --alt "description"
+```
+
+**⚠️ Posting risks**: Posting is more likely to be rate limited; if blocked, use the browser tool instead.
+
+## Media Uploads
+
+```bash
+bird tweet "hi" --media img.png --alt "description"
+bird tweet "pics" --media a.jpg --media b.jpg  # Up to 4 images
+bird tweet "video" --media clip.mp4            # Or 1 video
+```
+
+## Pagination
+
+Commands supporting pagination: `replies`, `thread`, `search`, `bookmarks`, `likes`, `list-timeline`, `following`, `followers`, `user-tweets`
+
+```bash
+bird bookmarks --all                    # Fetch all pages
+bird bookmarks --max-pages 3            # Limit pages
+bird bookmarks --cursor <cursor>        # Resume from cursor
+bird replies <id> --all --delay 1000    # Delay between pages (ms)
+```
+
+## Output Options
+
+```bash
+--json          # JSON output
+--json-full     # JSON with raw API response
+--plain         # No emoji, no color (script-friendly)
+--no-emoji      # Disable emoji
+--no-color      # Disable ANSI colors (or set NO_COLOR=1)
+--quote-depth n # Max quoted tweet depth in JSON (default: 1)
+```
+
+## Global Options
+
+```bash
+--auth-token <token>       # Set auth_token cookie
+--ct0 <token>              # Set ct0 cookie
+--cookie-source <source>   # Cookie source for browser cookies (repeatable)
+--chrome-profile <name>    # Chrome profile name
+--chrome-profile-dir <path> # Chrome/Chromium profile dir or cookie DB path
+--firefox-profile <name>   # Firefox profile
+--timeout <ms>             # Request timeout
+--cookie-timeout <ms>      # Cookie extraction timeout
+```
+
+## Config File
+
+`~/.config/bird/config.json5` (global) or `./.birdrc.json5` (project):
+
+```json5
+{
+  cookieSource: ["chrome"],
+  chromeProfileDir: "/path/to/Arc/Profile",
+  timeoutMs: 20000,
+  quoteDepth: 1,
+}
+```
+
+Environment variables: `BIRD_TIMEOUT_MS`, `BIRD_COOKIE_TIMEOUT_MS`, `BIRD_QUOTE_DEPTH`
+
+## Troubleshooting
+
+### Query IDs stale (404 errors)
+
+```bash
+bird query-ids --fresh
+```
+
+### Cookie extraction fails
+
+- Check browser is logged into X
+- Try different `--cookie-source`
+- For Arc/Brave: use `--chrome-profile-dir`
+
+---
+
+**TL;DR**: Read/search/engage with CLI. Post carefully or use browser. 🐦