atris 2.2.1 → 2.3.0

package/atris/skills/drive/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: drive
 description: Google Drive integration via AtrisOS API. Browse, search, read, upload files and work with Google Sheets. Use when user asks about Drive, files, docs, sheets, or spreadsheets.
-version: 1.0.0
+version: 1.1.0
 tags:
   - drive
   - backend
@@ -108,6 +108,14 @@ All requests require: `-H "Authorization: Bearer $TOKEN"`
 TOKEN=$(node -e "console.log(require('$HOME/.atris/credentials.json').token)")
 ```
 
+### List Shared Drives
+```bash
+curl -s "https://api.atris.ai/api/integrations/google-drive/shared-drives" \
+  -H "Authorization: Bearer $TOKEN"
+```
+
+Returns all shared/team drives the user has access to with `id` and `name`.
+
 ### List Files
 ```bash
 curl -s "https://api.atris.ai/api/integrations/google-drive/files?page_size=20" \
@@ -120,6 +128,14 @@ curl -s "https://api.atris.ai/api/integrations/google-drive/files?folder_id=FOLD
   -H "Authorization: Bearer $TOKEN"
 ```
 
+**List files in a shared drive:**
+```bash
+curl -s "https://api.atris.ai/api/integrations/google-drive/files?shared_drive_id=DRIVE_ID&page_size=20" \
+  -H "Authorization: Bearer $TOKEN"
+```
+
+**NOTE:** All file operations (list, search, get, download, export) automatically include shared drive files. Use `shared_drive_id` only to scope results to a specific shared drive.
+
 ### Search Files
 ```bash
 curl -s "https://api.atris.ai/api/integrations/google-drive/search?q=quarterly+report&page_size=20" \
@@ -266,6 +282,17 @@ curl -s -X POST "https://api.atris.ai/api/integrations/google-drive/sheets/{spre
 4. **Show user what will be appended, get approval**
 5. Append: `POST /google-drive/sheets/{id}/append`
 
+### "Browse a shared drive"
+1. Run bootstrap
+2. List shared drives: `GET /google-drive/shared-drives`
+3. Display drive names and IDs
+4. List files in chosen drive: `GET /google-drive/files?shared_drive_id=DRIVE_ID`
+
+### "Find a file across all drives"
+1. Run bootstrap
+2. Search: `GET /google-drive/search?q=QUERY` (automatically searches My Drive + all shared drives)
+3. Display results
+
 ### "Upload a file to Drive"
 1. Run bootstrap
 2. Read the local file content
@@ -309,7 +336,10 @@ TOKEN=$(node -e "console.log(require('$HOME/.atris/credentials.json').token)")
 # Check connection
 curl -s "https://api.atris.ai/api/integrations/google-drive/status" -H "Authorization: Bearer $TOKEN"
 
-# List files
+# List shared drives
+curl -s "https://api.atris.ai/api/integrations/google-drive/shared-drives" -H "Authorization: Bearer $TOKEN"
+
+# List files (includes shared drive files)
 curl -s "https://api.atris.ai/api/integrations/google-drive/files" -H "Authorization: Bearer $TOKEN"
 
 # Search files

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/slack/SKILL.md

@@ -0,0 +1,320 @@
+---
+name: slack
+description: Slack integration via AtrisOS API. Read messages, send as yourself, search conversations, manage DMs. Use when user asks about Slack, messages, channels, or team communication.
+version: 1.0.0
+tags:
+  - slack
+  - backend
+  - messaging
+---
+
+# Slack Agent
+
+> Drop this in `~/.claude/skills/slack/SKILL.md` and Claude Code becomes your Slack assistant.
+
+## Bootstrap (ALWAYS Run First)
+
+Before any Slack 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 Slack connection status
+STATUS=$(curl -s "https://api.atris.ai/api/integrations/slack/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 "Slack not connected. Getting authorization URL..."
+  AUTH=$(curl -s -X POST "https://api.atris.ai/api/integrations/slack/start" \
+    -H "Authorization: Bearer $TOKEN" \
+    -H "Content-Type: application/json" \
+    -d '{"mode":"personal"}')
+
+  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 Slack:"
+  echo "$URL"
+  echo ""
+  echo "After authorizing, run your command again."
+  exit 0
+fi
+
+echo "Ready. Slack 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)")
+```
+
+---
+
+## Personal Endpoints (send/read as yourself)
+
+These use your personal Slack token. Messages appear as YOU, not a bot.
+
+### List Your Channels & DMs
+```bash
+curl -s "https://api.atris.ai/api/integrations/slack/me/channels" \
+  -H "Authorization: Bearer $TOKEN"
+```
+
+### List Your DMs
+```bash
+curl -s "https://api.atris.ai/api/integrations/slack/me/dms" \
+  -H "Authorization: Bearer $TOKEN"
+```
+
+### Read Messages from a Channel or DM
+```bash
+curl -s "https://api.atris.ai/api/integrations/slack/me/messages/{channel_id}?limit=20" \
+  -H "Authorization: Bearer $TOKEN"
+```
+
+### Send Message as Yourself
+```bash
+curl -s -X POST "https://api.atris.ai/api/integrations/slack/me/send" \
+  -H "Authorization: Bearer $TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "channel": "C0123CHANNEL",
+    "text": "Hey team, here is the update..."
+  }'
+```
+
+**Reply in a thread:**
+```bash
+curl -s -X POST "https://api.atris.ai/api/integrations/slack/me/send" \
+  -H "Authorization: Bearer $TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "channel": "C0123CHANNEL",
+    "text": "Following up on this...",
+    "thread_ts": "1234567890.123456"
+  }'
+```
+
+### DM Someone as Yourself
+```bash
+curl -s -X POST "https://api.atris.ai/api/integrations/slack/me/dm" \
+  -H "Authorization: Bearer $TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "slack_user_id": "U0123USER",
+    "text": "Hey, quick question about the project..."
+  }'
+```
+
+### Search Messages
+```bash
+curl -s "https://api.atris.ai/api/integrations/slack/me/search?q=quarterly+report&count=20" \
+  -H "Authorization: Bearer $TOKEN"
+```
+
+---
+
+## Workspace Endpoints
+
+### List Channels (bot view)
+```bash
+curl -s "https://api.atris.ai/api/integrations/slack/channels" \
+  -H "Authorization: Bearer $TOKEN"
+```
+
+### List Users
+```bash
+curl -s "https://api.atris.ai/api/integrations/slack/users" \
+  -H "Authorization: Bearer $TOKEN"
+```
+
+### Send as Bot
+```bash
+curl -s -X POST "https://api.atris.ai/api/integrations/slack/test-send" \
+  -H "Authorization: Bearer $TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "channel": "C0123CHANNEL",
+    "message": "Hello from Atris!"
+  }'
+```
+
+### Check Connection Status
+```bash
+curl -s "https://api.atris.ai/api/integrations/slack/status" \
+  -H "Authorization: Bearer $TOKEN"
+```
+
+### Disconnect Slack
+```bash
+curl -s -X DELETE "https://api.atris.ai/api/integrations/slack" \
+  -H "Authorization: Bearer $TOKEN"
+```
+
+---
+
+## Workflows
+
+### "Check my Slack messages"
+1. Run bootstrap
+2. List DMs: `GET /slack/me/dms`
+3. For each open DM, read recent messages: `GET /slack/me/messages/{channel_id}?limit=5`
+4. Resolve user names: `GET /slack/users`
+5. Display: who messaged, what they said, when
+
+### "Send a message to someone"
+1. Run bootstrap
+2. Find the user: `GET /slack/users` (search by name/email)
+3. **Show user the draft for approval**
+4. Send DM: `POST /slack/me/dm` with `{user_id, text}`
+5. Confirm: "Message sent!"
+
+### "Reply in a channel"
+1. Run bootstrap
+2. List channels: `GET /slack/me/channels`
+3. Find the right channel
+4. Read recent messages: `GET /slack/me/messages/{channel_id}`
+5. **Show user the draft for approval**
+6. Send: `POST /slack/me/send` with `{channel, text}`
+
+### "Find a conversation about X"
+1. Run bootstrap
+2. Search: `GET /slack/me/search?q=X`
+3. Display matching messages with channel, sender, permalink
+
+### "What did [person] say to me?"
+1. Run bootstrap
+2. List users: `GET /slack/users` (find user ID)
+3. List DMs: `GET /slack/me/dms` (find DM channel with that user)
+4. Read messages: `GET /slack/me/messages/{channel_id}`
+5. Display conversation
+
+---
+
+## Important Notes
+
+- **Personal endpoints** (`/slack/me/*`) send messages as YOU, not a bot
+- **Bot endpoints** (`/slack/channels`, `/slack/test-send`) use the bot token
+- **Always get approval** before sending messages on behalf of the user
+- **Thread replies**: include `thread_ts` to reply in a thread instead of creating a new message
+- **User IDs**: Slack uses IDs like `U0123ABC`. Get them from `/slack/users` endpoint
+- **Channel IDs**: Use IDs like `C0123ABC`. Get them from `/slack/me/channels`
+
+---
+
+## Error Handling
+
+| Error | Meaning | Solution |
+|-------|---------|----------|
+| `Token expired` | AtrisOS session expired | Run `atris login` |
+| `Slack not connected` | OAuth not completed | Re-run bootstrap |
+| `Personal Slack not connected` | No user token | Re-connect Slack (needs re-auth for personal access) |
+| `401 Unauthorized` | Invalid/expired token | Run `atris login` |
+| `channel_not_found` | Invalid channel ID | Use `/slack/me/channels` to find correct ID |
+| `not_in_channel` | User not in channel | Join the channel first |
+
+---
+
+## Security Model
+
+1. **Local token** (`~/.atris/credentials.json`): Your AtrisOS auth token, stored locally.
+2. **Slack credentials**: Bot token and user token stored **server-side** in AtrisOS encrypted vault.
+3. **Two token types**: Bot token (xoxb-) for workspace operations, User token (xoxp-) for personal operations.
+4. **Access control**: AtrisOS API enforces that you can only access your own Slack.
+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/slack/status" -H "Authorization: Bearer $TOKEN"
+
+# List your DMs
+curl -s "https://api.atris.ai/api/integrations/slack/me/dms" -H "Authorization: Bearer $TOKEN"
+
+# Read messages
+curl -s "https://api.atris.ai/api/integrations/slack/me/messages/CHANNEL_ID" -H "Authorization: Bearer $TOKEN"
+
+# Send as yourself
+curl -s -X POST "https://api.atris.ai/api/integrations/slack/me/send" \
+  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
+  -d '{"channel":"C0123","text":"Hello!"}'
+
+# DM someone as yourself
+curl -s -X POST "https://api.atris.ai/api/integrations/slack/me/dm" \
+  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
+  -d '{"user_id":"U0123","text":"Hey!"}'
+
+# Search messages
+curl -s "https://api.atris.ai/api/integrations/slack/me/search?q=project+update" -H "Authorization: Bearer $TOKEN"
+
+# List workspace users
+curl -s "https://api.atris.ai/api/integrations/slack/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.1",
+  "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,
 };