atris 2.3.1 → 2.3.3

package/atris/skills/clawhub/atris/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: atris
-description: Codebase intelligence — generates structured navigation maps with file:line references so agents stop re-scanning the same files every session. Use when exploring code, answering "where is X?", or onboarding to a new codebase.
+description: "Codebase intelligence — generates structured navigation maps with file:line references so agents stop re-scanning the same files every session. Use when exploring code, answering 'where is X?', or onboarding to a new codebase."
 version: 1.1.0
 requires:
   bins:

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.1.0
+version: 1.2.0
 tags:
   - drive
   - backend
@@ -199,6 +199,29 @@ curl -s -X POST "https://api.atris.ai/api/integrations/google-drive/files" \
   }'
 ```
 
+### Update Existing File
+```bash
+curl -s -X PUT "https://api.atris.ai/api/integrations/google-drive/files/{file_id}" \
+  -H "Authorization: Bearer $TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "content": "Updated file content here",
+    "mime_type": "text/plain"
+  }'
+```
+
+**Update content and rename:**
+```bash
+curl -s -X PUT "https://api.atris.ai/api/integrations/google-drive/files/{file_id}" \
+  -H "Authorization: Bearer $TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "content": "New content",
+    "mime_type": "text/plain",
+    "name": "renamed-file.txt"
+  }'
+```
+
 ---
 
 ## Google Sheets
@@ -299,6 +322,14 @@ curl -s -X POST "https://api.atris.ai/api/integrations/google-drive/sheets/{spre
 3. **Confirm with user**: "Upload {filename} to Drive?"
 4. Upload: `POST /google-drive/files` with `{name, content, mime_type}`
 
+### "Edit a file on Drive"
+1. Run bootstrap
+2. Find the file: `GET /google-drive/search?q=FILENAME`
+3. Read current content: `GET /google-drive/files/{id}/export?mime_type=text/plain`
+4. Make edits
+5. **Show user the changes for approval**
+6. Update: `PUT /google-drive/files/{id}` with `{content, mime_type}`
+
 ---
 
 ## Error Handling
@@ -356,8 +387,13 @@ curl -s -X POST "https://api.atris.ai/api/integrations/google-drive/sheets/{id}/
   -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
   -d '{"range":"Sheet1","values":[["Alice",95]]}'
 
-# Upload a file
+# Upload a new file
 curl -s -X POST "https://api.atris.ai/api/integrations/google-drive/files" \
   -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
   -d '{"name":"notes.txt","content":"Hello world","mime_type":"text/plain"}'
+
+# Update an existing file
+curl -s -X PUT "https://api.atris.ai/api/integrations/google-drive/files/{file_id}" \
+  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
+  -d '{"content":"Updated content","mime_type":"text/plain"}'
 ```

package/atris/skills/email-agent/SKILL.md

@@ -250,6 +250,17 @@ curl -s -X DELETE "https://api.atris.ai/api/integrations/gmail/drafts/{draft_id}
   -H "Authorization: Bearer $TOKEN"
 ```
 
+### Mark as Read / Unread
+```bash
+# Mark as read
+curl -s -X POST "https://api.atris.ai/api/integrations/gmail/messages/{message_id}/read" \
+  -H "Authorization: Bearer $TOKEN"
+
+# Mark as unread
+curl -s -X POST "https://api.atris.ai/api/integrations/gmail/messages/{message_id}/unread" \
+  -H "Authorization: Bearer $TOKEN"
+```
+
 ### Archive Email
 ```bash
 # Single message
@@ -263,6 +274,19 @@ curl -s -X POST "https://api.atris.ai/api/integrations/gmail/messages/batch-arch
   -d '{"message_ids": ["id1", "id2", "id3"]}'
 ```
 
+### Trash Email
+```bash
+# Single message
+curl -s -X POST "https://api.atris.ai/api/integrations/gmail/messages/{message_id}/trash" \
+  -H "Authorization: Bearer $TOKEN"
+
+# Batch trash
+curl -s -X POST "https://api.atris.ai/api/integrations/gmail/messages/batch-trash" \
+  -H "Authorization: Bearer $TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{"message_ids": ["id1", "id2", "id3"]}'
+```
+
 ### Check Status
 ```bash
 curl -s "https://api.atris.ai/api/integrations/gmail/status" \
@@ -410,6 +434,12 @@ curl -s -X POST "https://api.atris.ai/api/integrations/gmail/drafts" \
   -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
   -d '{"to":"email@example.com","subject":"Hi","body":"Draft text"}'
 
+# Mark as read
+curl -s -X POST "https://api.atris.ai/api/integrations/gmail/messages/{message_id}/read" -H "Authorization: Bearer $TOKEN"
+
+# Trash an email
+curl -s -X POST "https://api.atris.ai/api/integrations/gmail/messages/{message_id}/trash" -H "Authorization: Bearer $TOKEN"
+
 # Send a draft
 curl -s -X POST "https://api.atris.ai/api/integrations/gmail/drafts/{draft_id}/send" \
   -H "Authorization: Bearer $TOKEN"

package/atris/skills/slack/SKILL.md

@@ -1,7 +1,7 @@
 ---
 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
+version: 1.1.0
 tags:
   - slack
   - backend
@@ -187,6 +187,14 @@ curl -s "https://api.atris.ai/api/integrations/slack/users" \
   -H "Authorization: Bearer $TOKEN"
 ```
 
+### Search Users
+```bash
+curl -s "https://api.atris.ai/api/integrations/slack/users/search?q=justin" \
+  -H "Authorization: Bearer $TOKEN"
+```
+
+Searches by name, display name, or email. Much faster than pulling the full user list.
+
 ### Send as Bot
 ```bash
 curl -s -X POST "https://api.atris.ai/api/integrations/slack/test-send" \
@@ -223,9 +231,9 @@ curl -s -X DELETE "https://api.atris.ai/api/integrations/slack" \
 
 ### "Send a message to someone"
 1. Run bootstrap
-2. Find the user: `GET /slack/users` (search by name/email)
+2. Find the user: `GET /slack/users/search?q=NAME`
 3. **Show user the draft for approval**
-4. Send DM: `POST /slack/me/dm` with `{user_id, text}`
+4. Send DM: `POST /slack/me/dm` with `{slack_user_id, text}`
 5. Confirm: "Message sent!"
 
 ### "Reply in a channel"
@@ -243,7 +251,7 @@ curl -s -X DELETE "https://api.atris.ai/api/integrations/slack" \
 
 ### "What did [person] say to me?"
 1. Run bootstrap
-2. List users: `GET /slack/users` (find user ID)
+2. Find user: `GET /slack/users/search?q=NAME` (get 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
@@ -317,4 +325,7 @@ curl -s "https://api.atris.ai/api/integrations/slack/me/search?q=project+update"
 
 # List workspace users
 curl -s "https://api.atris.ai/api/integrations/slack/users" -H "Authorization: Bearer $TOKEN"
+
+# Search users by name
+curl -s "https://api.atris.ai/api/integrations/slack/users/search?q=justin" -H "Authorization: Bearer $TOKEN"
 ```

package/atris/skills/writing/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: writing
-description: Essay writing skill. Triggers on: essay, draft, write, outline
+description: "Essay writing skill. Triggers on: essay, draft, write, outline"
 version: 1.0.0
 allowed-tools: Read, Write, Edit, Glob, Grep
 tags:

package/commands/sync.js

@@ -1,5 +1,6 @@
 const fs = require('fs');
 const path = require('path');
+const os = require('os');
 
 function syncAtris() {
   const targetDir = path.join(process.cwd(), 'atris');
@@ -293,83 +294,114 @@ After displaying the boot output, respond to the user naturally.
 }
 
 /**
- * Lightweight skill-only sync. Compares package skills against project skills
- * and updates any that differ. Called automatically from `atris activate`.
+ * Recursively sync files from src to dest. Returns count of files updated.
+ */
+function syncRecursiveCount(src, dest, label, silent) {
+  let count = 0;
+  if (!fs.existsSync(dest)) {
+    fs.mkdirSync(dest, { recursive: true });
+  }
+  const entries = fs.readdirSync(src);
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry);
+    const destPath = path.join(dest, entry);
+
+    if (fs.statSync(srcPath).isDirectory()) {
+      count += syncRecursiveCount(srcPath, destPath, `${label}/${entry}`, silent);
+    } else {
+      const srcContent = fs.readFileSync(srcPath, 'utf8');
+      const destContent = fs.existsSync(destPath) ? fs.readFileSync(destPath, 'utf8') : '';
+      if (srcContent !== destContent) {
+        fs.writeFileSync(destPath, srcContent);
+        if (entry.endsWith('.sh')) {
+          fs.chmodSync(destPath, 0o755);
+        }
+        if (!silent) {
+          console.log(`✓ Updated ${label}/${entry}`);
+        }
+        count++;
+      }
+    }
+  }
+  return count;
+}
+
+/**
+ * Lightweight skill-only sync. Syncs skills from the npm package to:
+ *   1. Global skill dirs (~/.claude/skills/, ~/.codex/skills/) — always, if they exist
+ *   2. Project-level (atris/skills/ + .claude/skills/ symlinks) — if in a project
+ *
+ * Global = baseline truth. Project = optional override.
  * Returns number of files updated (0 = already current).
  */
 function syncSkills({ silent = false } = {}) {
-  const targetDir = path.join(process.cwd(), 'atris');
   const packageSkillsDir = path.join(__dirname, '..', 'atris', 'skills');
-  const userSkillsDir = path.join(targetDir, 'skills');
-  const claudeSkillsBaseDir = path.join(process.cwd(), '.claude', 'skills');
-
-  if (!fs.existsSync(targetDir) || !fs.existsSync(packageSkillsDir)) {
+  if (!fs.existsSync(packageSkillsDir)) {
     return 0;
   }
 
-  if (!fs.existsSync(userSkillsDir)) {
-    fs.mkdirSync(userSkillsDir, { recursive: true });
-  }
-  if (!fs.existsSync(claudeSkillsBaseDir)) {
-    fs.mkdirSync(claudeSkillsBaseDir, { recursive: true });
-  }
-
   let updated = 0;
+  const homeDir = os.homedir();
 
   const skillFolders = fs.readdirSync(packageSkillsDir).filter(f =>
     fs.statSync(path.join(packageSkillsDir, f)).isDirectory()
   );
 
-  for (const skill of skillFolders) {
-    const srcSkillDir = path.join(packageSkillsDir, skill);
-    const destSkillDir = path.join(userSkillsDir, skill);
-    const symlinkPath = path.join(claudeSkillsBaseDir, skill);
+  // --- 1. Global skill directories (sync if they exist) ---
+  const globalSkillDirs = [
+    path.join(homeDir, '.claude', 'skills'),
+    path.join(homeDir, '.codex', 'skills'),
+  ];
 
-    const syncRecursive = (src, dest, skillName, basePath = '') => {
-      if (!fs.existsSync(dest)) {
-        fs.mkdirSync(dest, { recursive: true });
-      }
-      const entries = fs.readdirSync(src);
-      for (const entry of entries) {
-        const srcPath = path.join(src, entry);
-        const destPath = path.join(dest, entry);
-        const relPath = basePath ? `${basePath}/${entry}` : entry;
-
-        if (fs.statSync(srcPath).isDirectory()) {
-          syncRecursive(srcPath, destPath, skillName, relPath);
-        } else {
-          const srcContent = fs.readFileSync(srcPath, 'utf8');
-          const destContent = fs.existsSync(destPath) ? fs.readFileSync(destPath, 'utf8') : '';
-          if (srcContent !== destContent) {
-            fs.writeFileSync(destPath, srcContent);
-            if (entry.endsWith('.sh')) {
-              fs.chmodSync(destPath, 0o755);
-            }
-            if (!silent) {
-              console.log(`✓ Updated atris/skills/${skillName}/${relPath}`);
-            }
-            updated++;
-          }
-        }
+  for (const globalDir of globalSkillDirs) {
+    if (!fs.existsSync(globalDir)) continue;
+    const dirName = path.basename(path.dirname(globalDir)); // .claude or .codex
+
+    for (const skill of skillFolders) {
+      const srcSkillDir = path.join(packageSkillsDir, skill);
+      const destSkillDir = path.join(globalDir, skill);
+
+      if (fs.existsSync(destSkillDir) || fs.existsSync(globalDir)) {
+        updated += syncRecursiveCount(srcSkillDir, destSkillDir, `~/${dirName}/skills/${skill}`, silent);
       }
-    };
+    }
+  }
 
-    syncRecursive(srcSkillDir, destSkillDir, skill);
+  // --- 2. Project-level (only if inside an atris project) ---
+  const targetDir = path.join(process.cwd(), 'atris');
+  if (fs.existsSync(targetDir)) {
+    const userSkillsDir = path.join(targetDir, 'skills');
+    const claudeSkillsBaseDir = path.join(process.cwd(), '.claude', 'skills');
 
-    // Create symlink if doesn't exist
-    if (!fs.existsSync(symlinkPath)) {
-      const relativePath = path.join('..', '..', 'atris', 'skills', skill);
-      try {
-        fs.symlinkSync(relativePath, symlinkPath);
-        if (!silent) {
-          console.log(`✓ Linked .claude/skills/${skill}`);
-        }
-      } catch (e) {
-        // Fallback: copy instead of symlink
-        fs.mkdirSync(symlinkPath, { recursive: true });
-        const skillFile = path.join(destSkillDir, 'SKILL.md');
-        if (fs.existsSync(skillFile)) {
-          fs.copyFileSync(skillFile, path.join(symlinkPath, 'SKILL.md'));
+    if (!fs.existsSync(userSkillsDir)) {
+      fs.mkdirSync(userSkillsDir, { recursive: true });
+    }
+    if (!fs.existsSync(claudeSkillsBaseDir)) {
+      fs.mkdirSync(claudeSkillsBaseDir, { recursive: true });
+    }
+
+    for (const skill of skillFolders) {
+      const srcSkillDir = path.join(packageSkillsDir, skill);
+      const destSkillDir = path.join(userSkillsDir, skill);
+      const symlinkPath = path.join(claudeSkillsBaseDir, skill);
+
+      updated += syncRecursiveCount(srcSkillDir, destSkillDir, `atris/skills/${skill}`, silent);
+
+      // Create symlink if doesn't exist
+      if (!fs.existsSync(symlinkPath)) {
+        const relativePath = path.join('..', '..', 'atris', 'skills', skill);
+        try {
+          fs.symlinkSync(relativePath, symlinkPath);
+          if (!silent) {
+            console.log(`✓ Linked .claude/skills/${skill}`);
+          }
+        } catch (e) {
+          // Fallback: copy instead of symlink
+          fs.mkdirSync(symlinkPath, { recursive: true });
+          const skillFile = path.join(destSkillDir, 'SKILL.md');
+          if (fs.existsSync(skillFile)) {
+            fs.copyFileSync(skillFile, path.join(symlinkPath, 'SKILL.md'));
+          }
         }
       }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "atris",
-  "version": "2.3.1",
+  "version": "2.3.3",
   "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": {