atris 2.2.2 → 2.3.0

package/atris/skills/notion/SKILL.md

@@ -0,0 +1,478 @@
+---
+name: notion
+description: Notion integration via AtrisOS API. Search pages, read/create/update pages, query databases, manage blocks and comments. Use when user asks about Notion, pages, databases, wikis, or docs.
+version: 1.0.0
+tags:
+  - notion
+  - backend
+  - productivity
+---
+
+# Notion Agent
+
+> Drop this in `~/.claude/skills/notion/SKILL.md` and Claude Code becomes your Notion assistant.
+
+## Bootstrap (ALWAYS Run First)
+
+Before any Notion operation, run this bootstrap to ensure everything is set up:
+
+```bash
+#!/bin/bash
+set -e
+
+# 1. Check if atris CLI is installed
+if ! command -v atris &> /dev/null; then
+  echo "Installing atris CLI..."
+  npm install -g atris
+fi
+
+# 2. Check if logged in to AtrisOS
+if [ ! -f ~/.atris/credentials.json ]; then
+  echo "Not logged in to AtrisOS."
+  echo ""
+  echo "Option 1 (interactive): Run 'atris login' and follow prompts"
+  echo "Option 2 (non-interactive): Get token from https://atris.ai/auth/cli"
+  echo "                           Then run: atris login --token YOUR_TOKEN"
+  echo ""
+  exit 1
+fi
+
+# 3. Extract token
+if command -v node &> /dev/null; then
+  TOKEN=$(node -e "console.log(require('$HOME/.atris/credentials.json').token)")
+elif command -v python3 &> /dev/null; then
+  TOKEN=$(python3 -c "import json,os; print(json.load(open(os.path.expanduser('~/.atris/credentials.json')))['token'])")
+elif command -v jq &> /dev/null; then
+  TOKEN=$(jq -r '.token' ~/.atris/credentials.json)
+else
+  echo "Error: Need node, python3, or jq to read credentials"
+  exit 1
+fi
+
+# 4. Check Notion connection status
+STATUS=$(curl -s "https://api.atris.ai/api/integrations/notion/status" \
+  -H "Authorization: Bearer $TOKEN")
+
+if echo "$STATUS" | grep -q "Token expired\|Not authenticated"; then
+  echo "Token expired. Please re-authenticate:"
+  echo "  Run: atris login --force"
+  exit 1
+fi
+
+if command -v node &> /dev/null; then
+  CONNECTED=$(node -e "try{console.log(JSON.parse('$STATUS').connected||false)}catch(e){console.log(false)}")
+elif command -v python3 &> /dev/null; then
+  CONNECTED=$(echo "$STATUS" | python3 -c "import sys,json; print(json.load(sys.stdin).get('connected', False))")
+else
+  CONNECTED=$(echo "$STATUS" | jq -r '.connected // false')
+fi
+
+if [ "$CONNECTED" != "true" ] && [ "$CONNECTED" != "True" ]; then
+  echo "Notion not connected. Getting authorization URL..."
+  AUTH=$(curl -s -X POST "https://api.atris.ai/api/integrations/notion/start" \
+    -H "Authorization: Bearer $TOKEN" \
+    -H "Content-Type: application/json" \
+    -d '{"return_url":"https://atris.ai/dashboard/settings"}')
+
+  if command -v node &> /dev/null; then
+    URL=$(node -e "try{console.log(JSON.parse('$AUTH').auth_url||'')}catch(e){console.log('')}")
+  elif command -v python3 &> /dev/null; then
+    URL=$(echo "$AUTH" | python3 -c "import sys,json; print(json.load(sys.stdin).get('auth_url', ''))")
+  else
+    URL=$(echo "$AUTH" | jq -r '.auth_url // empty')
+  fi
+
+  echo ""
+  echo "Open this URL to connect your Notion:"
+  echo "$URL"
+  echo ""
+  echo "After authorizing, run your command again."
+  exit 0
+fi
+
+echo "Ready. Notion is connected."
+export ATRIS_TOKEN="$TOKEN"
+```
+
+---
+
+## API Reference
+
+Base: `https://api.atris.ai/api/integrations`
+
+All requests require: `-H "Authorization: Bearer $TOKEN"`
+
+### Get Token (after bootstrap)
+```bash
+TOKEN=$(node -e "console.log(require('$HOME/.atris/credentials.json').token)")
+```
+
+---
+
+## Search
+
+### Search Pages & Databases
+```bash
+curl -s "https://api.atris.ai/api/integrations/notion/search?q=meeting+notes&page_size=20" \
+  -H "Authorization: Bearer $TOKEN"
+```
+
+**Filter by type:**
+```bash
+# Only pages
+curl -s "https://api.atris.ai/api/integrations/notion/search?q=roadmap&filter_type=page" \
+  -H "Authorization: Bearer $TOKEN"
+
+# Only databases
+curl -s "https://api.atris.ai/api/integrations/notion/search?q=tasks&filter_type=database" \
+  -H "Authorization: Bearer $TOKEN"
+```
+
+---
+
+## Pages
+
+### Get a Page
+```bash
+curl -s "https://api.atris.ai/api/integrations/notion/pages/{page_id}" \
+  -H "Authorization: Bearer $TOKEN"
+```
+
+### Create a Page (under a page)
+```bash
+curl -s -X POST "https://api.atris.ai/api/integrations/notion/pages" \
+  -H "Authorization: Bearer $TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "parent_id": "PARENT_PAGE_ID",
+    "parent_type": "page_id",
+    "title": "Meeting Notes - Feb 14"
+  }'
+```
+
+### Create a Page (in a database)
+```bash
+curl -s -X POST "https://api.atris.ai/api/integrations/notion/pages" \
+  -H "Authorization: Bearer $TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "parent_id": "DATABASE_ID",
+    "parent_type": "database_id",
+    "title": "New Task",
+    "properties": {
+      "Status": {"select": {"name": "In Progress"}},
+      "Priority": {"select": {"name": "High"}}
+    }
+  }'
+```
+
+### Create a Page with Content
+```bash
+curl -s -X POST "https://api.atris.ai/api/integrations/notion/pages" \
+  -H "Authorization: Bearer $TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "parent_id": "PARENT_PAGE_ID",
+    "parent_type": "page_id",
+    "title": "Project Brief",
+    "children": [
+      {
+        "object": "block",
+        "type": "heading_2",
+        "heading_2": {"rich_text": [{"type": "text", "text": {"content": "Overview"}}]}
+      },
+      {
+        "object": "block",
+        "type": "paragraph",
+        "paragraph": {"rich_text": [{"type": "text", "text": {"content": "This project aims to..."}}]}
+      },
+      {
+        "object": "block",
+        "type": "bulleted_list_item",
+        "bulleted_list_item": {"rich_text": [{"type": "text", "text": {"content": "Goal 1: Ship MVP"}}]}
+      }
+    ]
+  }'
+```
+
+### Update a Page
+```bash
+curl -s -X PATCH "https://api.atris.ai/api/integrations/notion/pages/{page_id}" \
+  -H "Authorization: Bearer $TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "properties": {
+      "Status": {"select": {"name": "Done"}}
+    }
+  }'
+```
+
+### Archive a Page
+```bash
+curl -s -X PATCH "https://api.atris.ai/api/integrations/notion/pages/{page_id}" \
+  -H "Authorization: Bearer $TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{"archived": true}'
+```
+
+---
+
+## Databases
+
+### Get Database Schema
+```bash
+curl -s "https://api.atris.ai/api/integrations/notion/databases/{database_id}" \
+  -H "Authorization: Bearer $TOKEN"
+```
+
+### Query a Database
+```bash
+curl -s -X POST "https://api.atris.ai/api/integrations/notion/databases/{database_id}/query" \
+  -H "Authorization: Bearer $TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{"page_size": 20}'
+```
+
+**With filters:**
+```bash
+curl -s -X POST "https://api.atris.ai/api/integrations/notion/databases/{database_id}/query" \
+  -H "Authorization: Bearer $TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "filter": {
+      "property": "Status",
+      "select": {"equals": "In Progress"}
+    },
+    "sorts": [
+      {"property": "Created", "direction": "descending"}
+    ],
+    "page_size": 50
+  }'
+```
+
+### Create a Database
+```bash
+curl -s -X POST "https://api.atris.ai/api/integrations/notion/databases" \
+  -H "Authorization: Bearer $TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "parent_page_id": "PAGE_ID",
+    "title": "Task Tracker",
+    "properties": {
+      "Name": {"title": {}},
+      "Status": {"select": {"options": [{"name": "To Do"}, {"name": "In Progress"}, {"name": "Done"}]}},
+      "Priority": {"select": {"options": [{"name": "High"}, {"name": "Medium"}, {"name": "Low"}]}},
+      "Due Date": {"date": {}}
+    }
+  }'
+```
+
+---
+
+## Blocks (Page Content)
+
+### Read Page Content
+```bash
+curl -s "https://api.atris.ai/api/integrations/notion/blocks/{page_id}/children?page_size=50" \
+  -H "Authorization: Bearer $TOKEN"
+```
+
+### Append Content to a Page
+```bash
+curl -s -X PATCH "https://api.atris.ai/api/integrations/notion/blocks/{page_id}/children" \
+  -H "Authorization: Bearer $TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "children": [
+      {
+        "object": "block",
+        "type": "paragraph",
+        "paragraph": {"rich_text": [{"type": "text", "text": {"content": "Added via Atris!"}}]}
+      }
+    ]
+  }'
+```
+
+### Delete a Block
+```bash
+curl -s -X DELETE "https://api.atris.ai/api/integrations/notion/blocks/{block_id}" \
+  -H "Authorization: Bearer $TOKEN"
+```
+
+---
+
+## Users
+
+### List Workspace Users
+```bash
+curl -s "https://api.atris.ai/api/integrations/notion/users" \
+  -H "Authorization: Bearer $TOKEN"
+```
+
+### Get Integration Info
+```bash
+curl -s "https://api.atris.ai/api/integrations/notion/me" \
+  -H "Authorization: Bearer $TOKEN"
+```
+
+---
+
+## Comments
+
+### Get Comments on a Page
+```bash
+curl -s "https://api.atris.ai/api/integrations/notion/comments/{page_id}" \
+  -H "Authorization: Bearer $TOKEN"
+```
+
+### Add a Comment
+```bash
+curl -s -X POST "https://api.atris.ai/api/integrations/notion/comments" \
+  -H "Authorization: Bearer $TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "parent_id": "PAGE_ID",
+    "text": "This looks great! Approved."
+  }'
+```
+
+### Reply to a Discussion
+```bash
+curl -s -X POST "https://api.atris.ai/api/integrations/notion/comments" \
+  -H "Authorization: Bearer $TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "parent_id": "PAGE_ID",
+    "text": "Thanks for the feedback!",
+    "discussion_id": "DISCUSSION_ID"
+  }'
+```
+
+---
+
+## Workflows
+
+### "Search my Notion for X"
+1. Run bootstrap
+2. Search: `GET /notion/search?q=X`
+3. Display: title, type (page/database), last edited
+
+### "What's in my task database?"
+1. Run bootstrap
+2. Search databases: `GET /notion/search?q=tasks&filter_type=database`
+3. Query: `POST /notion/databases/{id}/query` with filters
+4. Display rows with properties
+
+### "Create a page with notes"
+1. Run bootstrap
+2. Search for parent page: `GET /notion/search?q=parent+name&filter_type=page`
+3. Create page: `POST /notion/pages` with title + children blocks
+4. Confirm: "Page created!" with link
+
+### "Add a row to a database"
+1. Run bootstrap
+2. Get database schema: `GET /notion/databases/{id}` (to see property names/types)
+3. Create page in database: `POST /notion/pages` with `parent_type=database_id` and matching properties
+4. Confirm with row details
+
+### "Read a page"
+1. Run bootstrap
+2. Get page metadata: `GET /notion/pages/{id}`
+3. Get page content: `GET /notion/blocks/{id}/children`
+4. Display title + content blocks
+
+### "Update task status"
+1. Run bootstrap
+2. Find the task: search or query database
+3. Update: `PATCH /notion/pages/{id}` with new property values
+4. Confirm the change
+
+---
+
+## Block Types Reference
+
+Common block types for creating content:
+
+| Type | Key | Rich text field |
+|------|-----|----------------|
+| Paragraph | `paragraph` | `rich_text` |
+| Heading 1 | `heading_1` | `rich_text` |
+| Heading 2 | `heading_2` | `rich_text` |
+| Heading 3 | `heading_3` | `rich_text` |
+| Bullet list | `bulleted_list_item` | `rich_text` |
+| Numbered list | `numbered_list_item` | `rich_text` |
+| To-do | `to_do` | `rich_text` + `checked` |
+| Code | `code` | `rich_text` + `language` |
+| Quote | `quote` | `rich_text` |
+| Divider | `divider` | (none) |
+| Callout | `callout` | `rich_text` + `icon` |
+
+---
+
+## Important Notes
+
+- **Notion tokens don't expire** — once connected, it stays connected
+- **Page IDs**: Notion uses UUIDs like `12345678-abcd-1234-abcd-123456789abc`. You can get them from URLs or search results
+- **Database pages**: When adding rows to a database, the "page" properties must match the database schema
+- **Content = Blocks**: A page's visible content is a list of blocks. Use the blocks endpoint to read/write content
+- **Search scope**: Only pages/databases shared with the Atris integration are visible
+
+---
+
+## Error Handling
+
+| Error | Meaning | Solution |
+|-------|---------|----------|
+| `Token expired` | AtrisOS session expired | Run `atris login` |
+| `Notion not connected` | OAuth not completed | Re-run bootstrap |
+| `401 Unauthorized` | Invalid/expired token | Run `atris login` |
+| `object_not_found` | Page/database not shared with integration | Share the page with the Atris integration in Notion |
+| `validation_error` | Bad request format | Check property names match database schema |
+| `restricted_resource` | No access to resource | Share with Atris integration in Notion settings |
+
+---
+
+## Security Model
+
+1. **Local token** (`~/.atris/credentials.json`): Your AtrisOS auth token, stored locally.
+2. **Notion credentials**: Access token stored **server-side** in AtrisOS encrypted vault.
+3. **Access control**: AtrisOS API enforces that you can only access your own Notion.
+4. **Scoped access**: Only pages/databases explicitly shared with the Atris integration are accessible.
+5. **HTTPS only**: All API communication encrypted in transit.
+
+---
+
+## Quick Reference
+
+```bash
+# Setup (one time)
+npm install -g atris && atris login
+
+# Get token
+TOKEN=$(node -e "console.log(require('$HOME/.atris/credentials.json').token)")
+
+# Check connection
+curl -s "https://api.atris.ai/api/integrations/notion/status" -H "Authorization: Bearer $TOKEN"
+
+# Search
+curl -s "https://api.atris.ai/api/integrations/notion/search?q=meeting" -H "Authorization: Bearer $TOKEN"
+
+# Read a page
+curl -s "https://api.atris.ai/api/integrations/notion/pages/PAGE_ID" -H "Authorization: Bearer $TOKEN"
+
+# Read page content
+curl -s "https://api.atris.ai/api/integrations/notion/blocks/PAGE_ID/children" -H "Authorization: Bearer $TOKEN"
+
+# Create a page
+curl -s -X POST "https://api.atris.ai/api/integrations/notion/pages" \
+  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
+  -d '{"parent_id":"PAGE_ID","parent_type":"page_id","title":"New Page"}'
+
+# Query a database
+curl -s -X POST "https://api.atris.ai/api/integrations/notion/databases/DB_ID/query" \
+  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
+  -d '{"page_size":20}'
+
+# List users
+curl -s "https://api.atris.ai/api/integrations/notion/users" -H "Authorization: Bearer $TOKEN"
+```

package/atris/skills/slides/SKILL.md

@@ -0,0 +1,355 @@
+---
+name: slides
+description: Google Slides integration via AtrisOS API. List, create, read, and update presentations. Add slides, text, shapes, images. Export to PDF. Use when user asks about slides, presentations, decks, or pitch decks.
+version: 1.0.0
+tags:
+  - slides
+  - google
+  - productivity
+---
+
+# Google Slides Agent
+
+> Drop this in `~/.claude/skills/slides/SKILL.md` and Claude Code becomes your presentation assistant.
+
+## Prerequisites
+
+Google Slides shares OAuth with Google Drive. If Drive is connected, Slides works automatically. If not:
+
+```bash
+TOKEN=$(node -e "console.log(require('$HOME/.atris/credentials.json').token)")
+
+# Check if Drive is connected (Slides piggybacks on Drive)
+curl -s "https://api.atris.ai/api/integrations/google-drive/status" -H "Authorization: Bearer $TOKEN"
+
+# If not connected, start Drive OAuth (includes Slides scope)
+curl -s -X POST "https://api.atris.ai/api/integrations/google-drive/start" \
+  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
+  -d '{"next_url":"https://atris.ai/dashboard/settings"}'
+```
+
+---
+
+## API Reference
+
+Base: `https://api.atris.ai/api/integrations/google-slides`
+
+All requests require: `-H "Authorization: Bearer $TOKEN"`
+
+### Get Token
+```bash
+TOKEN=$(node -e "console.log(require('$HOME/.atris/credentials.json').token)")
+```
+
+---
+
+## Presentations
+
+### List Presentations
+```bash
+curl -s "https://api.atris.ai/api/integrations/google-slides/presentations?page_size=20" \
+  -H "Authorization: Bearer $TOKEN"
+```
+
+### Get a Presentation (with all slides)
+```bash
+curl -s "https://api.atris.ai/api/integrations/google-slides/presentations/{presentation_id}" \
+  -H "Authorization: Bearer $TOKEN"
+```
+
+### Create a Presentation
+```bash
+curl -s -X POST "https://api.atris.ai/api/integrations/google-slides/presentations" \
+  -H "Authorization: Bearer $TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{"title": "Q1 2026 Review"}'
+```
+
+---
+
+## Updating Slides (batch-update)
+
+All slide mutations use the batch-update endpoint. This is the most powerful endpoint — it can add slides, insert text, add shapes, images, change formatting, and more.
+
+```bash
+curl -s -X POST "https://api.atris.ai/api/integrations/google-slides/presentations/{id}/batch-update" \
+  -H "Authorization: Bearer $TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{"requests": [...]}'
+```
+
+### Add a Blank Slide
+```json
+{
+  "requests": [
+    {
+      "createSlide": {
+        "insertionIndex": 1,
+        "slideLayoutReference": {
+          "predefinedLayout": "BLANK"
+        }
+      }
+    }
+  ]
+}
+```
+
+**Available layouts:** `BLANK`, `TITLE`, `TITLE_AND_BODY`, `TITLE_AND_TWO_COLUMNS`, `TITLE_ONLY`, `SECTION_HEADER`, `SECTION_TITLE_AND_DESCRIPTION`, `ONE_COLUMN_TEXT`, `MAIN_POINT`, `BIG_NUMBER`
+
+### Add a Title Slide
+```json
+{
+  "requests": [
+    {
+      "createSlide": {
+        "insertionIndex": 0,
+        "slideLayoutReference": {
+          "predefinedLayout": "TITLE"
+        },
+        "placeholderIdMappings": [
+          {"layoutPlaceholder": {"type": "TITLE"}, "objectId": "titleId"},
+          {"layoutPlaceholder": {"type": "SUBTITLE"}, "objectId": "subtitleId"}
+        ]
+      }
+    },
+    {
+      "insertText": {
+        "objectId": "titleId",
+        "text": "Q1 2026 Review"
+      }
+    },
+    {
+      "insertText": {
+        "objectId": "subtitleId",
+        "text": "Atris Labs - Confidential"
+      }
+    }
+  ]
+}
+```
+
+### Insert Text into an Element
+```json
+{
+  "requests": [
+    {
+      "insertText": {
+        "objectId": "ELEMENT_ID",
+        "text": "Hello, world!"
+      }
+    }
+  ]
+}
+```
+
+### Add a Text Box
+```json
+{
+  "requests": [
+    {
+      "createShape": {
+        "objectId": "myTextBox1",
+        "shapeType": "TEXT_BOX",
+        "elementProperties": {
+          "pageObjectId": "SLIDE_ID",
+          "size": {
+            "width": {"magnitude": 400, "unit": "PT"},
+            "height": {"magnitude": 50, "unit": "PT"}
+          },
+          "transform": {
+            "scaleX": 1, "scaleY": 1,
+            "translateX": 100, "translateY": 200,
+            "unit": "PT"
+          }
+        }
+      }
+    },
+    {
+      "insertText": {
+        "objectId": "myTextBox1",
+        "text": "Custom text here"
+      }
+    }
+  ]
+}
+```
+
+### Add an Image
+```json
+{
+  "requests": [
+    {
+      "createImage": {
+        "objectId": "myImage1",
+        "url": "https://example.com/image.png",
+        "elementProperties": {
+          "pageObjectId": "SLIDE_ID",
+          "size": {
+            "width": {"magnitude": 300, "unit": "PT"},
+            "height": {"magnitude": 200, "unit": "PT"}
+          },
+          "transform": {
+            "scaleX": 1, "scaleY": 1,
+            "translateX": 150, "translateY": 100,
+            "unit": "PT"
+          }
+        }
+      }
+    }
+  ]
+}
+```
+
+### Replace All Text (find & replace)
+```json
+{
+  "requests": [
+    {
+      "replaceAllText": {
+        "containsText": {"text": "{{company_name}}"},
+        "replaceText": "Atris Labs"
+      }
+    }
+  ]
+}
+```
+
+### Delete a Slide or Element
+```json
+{
+  "requests": [
+    {
+      "deleteObject": {
+        "objectId": "SLIDE_OR_ELEMENT_ID"
+      }
+    }
+  ]
+}
+```
+
+### Style Text
+```json
+{
+  "requests": [
+    {
+      "updateTextStyle": {
+        "objectId": "ELEMENT_ID",
+        "style": {
+          "bold": true,
+          "fontSize": {"magnitude": 24, "unit": "PT"},
+          "foregroundColor": {
+            "opaqueColor": {"rgbColor": {"red": 0.2, "green": 0.2, "blue": 0.8}}
+          }
+        },
+        "fields": "bold,fontSize,foregroundColor"
+      }
+    }
+  ]
+}
+```
+
+---
+
+## Pages (Individual Slides)
+
+### Get a Single Slide
+```bash
+curl -s "https://api.atris.ai/api/integrations/google-slides/presentations/{id}/pages/{page_id}" \
+  -H "Authorization: Bearer $TOKEN"
+```
+
+### Get Slide Thumbnail
+```bash
+curl -s "https://api.atris.ai/api/integrations/google-slides/presentations/{id}/pages/{page_id}/thumbnail" \
+  -H "Authorization: Bearer $TOKEN"
+```
+
+---
+
+## Export
+
+### Export as PDF
+```bash
+curl -s "https://api.atris.ai/api/integrations/google-slides/presentations/{id}/export" \
+  -H "Authorization: Bearer $TOKEN"
+```
+Returns `{"pdf_base64": "...", "content_type": "application/pdf"}`.
+
+---
+
+## Workflows
+
+### "Create a pitch deck"
+1. Create presentation: `POST /presentations` with title
+2. Get the presentation to find the first slide ID
+3. Batch update: add title slide, content slides, closing slide
+4. Each slide: createSlide + insertText for content
+5. Return the presentation URL: `https://docs.google.com/presentation/d/{id}`
+
+### "List my presentations"
+1. `GET /presentations`
+2. Display: name, last modified, link
+
+### "Add a slide to an existing deck"
+1. `GET /presentations/{id}` to see current slides
+2. Batch update: createSlide at the desired index
+3. Add content with insertText, createShape, createImage
+
+### "Export deck to PDF"
+1. `GET /presentations/{id}/export`
+2. Decode base64 and save to file
+
+### "Update text in a deck"
+1. `GET /presentations/{id}` to find element IDs
+2. Batch update with replaceAllText for template variables
+3. Or insertText/deleteText for specific elements
+
+---
+
+## Important Notes
+
+- **Shares Drive OAuth** — no separate connection needed. If Drive is connected, Slides works
+- **Batch update is everything** — all slide mutations (add, edit, delete, style) go through batch-update
+- **Object IDs** — every slide, shape, text box, image has an ID. Get them from `GET /presentations/{id}`
+- **Slide size** — default is 10x5.63 inches (720x406.5 PT). Position elements accordingly
+- **Images** — must be publicly accessible URLs. For private images, upload to Drive first
+- **Templates** — use replaceAllText with `{{placeholder}}` patterns for template-based decks
+
+---
+
+## Error Handling
+
+| Error | Meaning | Solution |
+|-------|---------|----------|
+| `Drive not connected` | No Drive OAuth token | Connect Google Drive first |
+| `403 insufficient_scope` | Token missing presentations scope | Reconnect Drive to get updated scopes |
+| `404 not_found` | Presentation doesn't exist | Check presentation ID |
+| `400 invalid_request` | Bad batch update request | Check request format against API docs |
+
+---
+
+## Quick Reference
+
+```bash
+# Get token
+TOKEN=$(node -e "console.log(require('$HOME/.atris/credentials.json').token)")
+
+# List presentations
+curl -s "https://api.atris.ai/api/integrations/google-slides/presentations" -H "Authorization: Bearer $TOKEN"
+
+# Create presentation
+curl -s -X POST "https://api.atris.ai/api/integrations/google-slides/presentations" \
+  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
+  -d '{"title":"My Deck"}'
+
+# Get presentation (with all slides)
+curl -s "https://api.atris.ai/api/integrations/google-slides/presentations/PRES_ID" -H "Authorization: Bearer $TOKEN"
+
+# Add a slide with text
+curl -s -X POST "https://api.atris.ai/api/integrations/google-slides/presentations/PRES_ID/batch-update" \
+  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
+  -d '{"requests":[{"createSlide":{"slideLayoutReference":{"predefinedLayout":"TITLE_AND_BODY"}}}]}'
+
+# Export as PDF
+curl -s "https://api.atris.ai/api/integrations/google-slides/presentations/PRES_ID/export" -H "Authorization: Bearer $TOKEN"
+```

package/bin/atris.js

@@ -25,7 +25,7 @@ const DEFAULT_CLIENT_ID = `AtrisCLI/${CLI_VERSION}`;
 const DEFAULT_USER_AGENT = `${DEFAULT_CLIENT_ID} (node ${process.version}; ${os.platform()} ${os.release()} ${os.arch()})`;
 
 // Update check utility
-const { checkForUpdates, showUpdateNotification } = require('../utils/update-check');
+const { checkForUpdates, showUpdateNotification, autoUpdate } = require('../utils/update-check');
 
 // State detection for smart default
 const { detectWorkspaceState, loadContext } = require('../lib/state-detection');
@@ -39,9 +39,11 @@ if (!skipUpdateCheck && (!process.argv[2] || (process.argv[2] && !['version', 'u
     .then((updateInfo) => {
       // Show notification if update available (after command completes)
       if (updateInfo) {
-        // Wait a bit for command output to finish, then show notification
+        // Auto-update in background, fall back to notification if it fails
         setTimeout(() => {
-          showUpdateNotification(updateInfo);
+          if (!autoUpdate(updateInfo)) {
+            showUpdateNotification(updateInfo);
+          }
         }, 100);
       }
       return updateInfo;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "atris",
-  "version": "2.2.2",
+  "version": "2.3.0",
   "description": "atrisDev (atris dev) - CLI for AI coding agents. Works with Claude Code, Cursor, Windsurf. Make any codebase AI-navigable.",
   "main": "bin/atris.js",
   "bin": {

package/utils/update-check.js

@@ -175,8 +175,41 @@ function showUpdateNotification(updateInfo) {
   console.log('');
 }
 
+function autoUpdate(updateInfo) {
+  if (!updateInfo || !updateInfo.needsUpdate) return false;
+
+  const { execSync } = require('child_process');
+
+  console.log('');
+  console.log(`⬆️  Updating atris ${updateInfo.installed} → ${updateInfo.latest}...`);
+
+  try {
+    execSync('npm update -g atris', { stdio: 'pipe', timeout: 30000 });
+    console.log(`✅ Updated to ${updateInfo.latest}`);
+
+    // Auto-sync skills into current project if atris/skills/ exists
+    try {
+      if (fs.existsSync(path.join(process.cwd(), 'atris', 'skills'))) {
+        execSync('atris sync', { stdio: 'pipe', timeout: 10000 });
+        console.log(`✅ Skills synced`);
+      }
+    } catch (e) {
+      // Sync failed — not critical
+    }
+
+    console.log('');
+    return true;
+  } catch (error) {
+    // npm update failed (permissions, network, etc) — fall back to notification
+    console.log(`⚠️  Auto-update failed. Run manually: npm update -g atris`);
+    console.log('');
+    return false;
+  }
+}
+
 module.exports = {
   checkForUpdates,
   showUpdateNotification,
+  autoUpdate,
 };