beepctl 0.1.2 → 0.1.3

package/README.md

@@ -34,7 +34,8 @@ pnpm link --global
 2. Go to **Settings → Developers**
 3. Enable **Beeper Desktop API**
 4. Click **"+"** next to "Approved connections" to create a token
-5. Configure the CLI:
+5. *(Optional)* Enable **"Allow sensitive actions"** on the token to send messages
+6. Configure the CLI:
 
 ```bash
 beepctl auth set <your-token>
@@ -44,54 +45,74 @@ export BEEPER_TOKEN=<your-token>
 
 ## Configuration
 
-Config stored at `~/.config/beepcli/config.json` with token, base URL, and aliases.
+Config stored at `~/.config/beepctl/config.json` with token, base URL, and aliases.
 
 **Precedence:** Environment variables (`BEEPER_TOKEN`, `BEEPER_URL`) override config file.
 
 ## Usage
 
+### Auth Management
+
 ```bash
-# Auth management
 beepctl auth show           # Check auth status
 beepctl auth set <token>    # Set API token
 beepctl auth clear          # Clear stored token
+```
+
+### Accounts
+
+```bash
+beepctl accounts            # List all connected accounts
+```
+
+### Chats
+
+```bash
+# List chats
+beepctl chats list                            # List inbox (non-archived)
+beepctl chats list --limit 50                 # Limit results
+beepctl chats list --search "John"            # Filter by name
+beepctl chats list --inbox archive            # Archived chats only
+beepctl chats list --inbox low-priority       # Low-priority chats
+beepctl chats list --inbox all                # All chats (including archived)
+beepctl chats list --type group               # Filter by type (single/group/any)
+beepctl chats list --unread-only              # Unread chats only
+beepctl chats list --activity-after "1d ago"  # Recent activity filter
+
+# Chat details
+beepctl chats show <chat-id>                  # Detailed info with participants
+
+# Create chat
+beepctl chats create <account-id> <user-ids...>  # Create new single/group chat
+```
+
+**Inbox filters:** `primary` (default), `archive`, `low-priority`, `all`
+
+### Messages
 
-# List connected accounts
-beepctl accounts
+Browse messages in a specific chat:
 
-# List recent chats
-beepctl chats
-beepctl chats --limit 50
-beepctl chats --search "John"
+```bash
+beepctl messages <chat-id>                    # List recent messages
+beepctl messages <chat-id> --limit 20         # Limit results
+beepctl messages <chat-id> --after "1d ago"   # Messages after a time
+beepctl messages <chat-id> --before "1h ago"  # Messages before a time
+beepctl messages work                         # Use alias
+```
 
-# Search messages and chats
+### Search
+
+Search messages across all chats:
+
+```bash
 beepctl search "meeting tomorrow"
 beepctl search "deadline" --limit 10
 beepctl search "deadline" --chat work --sender me --after "1d ago"
 beepctl search "photo" --media image video
 beepctl search "discussion" --chat-type group --before "yesterday"
-
-# Send messages
-beepctl send <chat-id> "Hello!"
-beepctl send myself "Quick note"  # Send to yourself
-beepctl send <chat-id> "Thanks!" --reply-to <message-id>  # Reply to message
-
-# Archive/unarchive chats
-beepctl archive <chat-id>              # Archive a chat
-beepctl archive <chat-id> --unarchive  # Unarchive a chat
-beepctl archive work                   # Use alias to archive
-
-# Alias management (shortcuts for chat IDs)
-beepctl alias list                    # List all aliases
-beepctl alias add work <chat-id>      # Create alias
-beepctl alias show work               # Show alias value
-beepctl alias remove work             # Remove alias
-beepctl send work "Using alias!"      # Use alias in commands
 ```
 
-### Search Filters
-
-Filter search results with multiple options:
+#### Search Filters
 
 ```bash
 # Filter by chat (supports aliases, space or comma-separated)
@@ -129,6 +150,83 @@ beepctl search "important" --exclude-muted
 
 **Media types:** `any`, `video`, `image`, `link`, `file`
 
+### Send Messages
+
+```bash
+beepctl send <chat-id> "Hello!"                      # Send message
+beepctl send myself "Quick note"                     # Send to yourself
+beepctl send <chat-id> "Thanks!" --reply-to <msg-id> # Reply to message
+beepctl send <chat-id> "msg" --quiet                 # No confirmation output
+```
+
+### Focus (Bring to Foreground)
+
+Bring Beeper Desktop to foreground and optionally open a chat:
+
+```bash
+beepctl focus                             # Bring Beeper to foreground
+beepctl focus <chat-id>                   # Open a specific chat
+beepctl focus work                        # Use alias
+beepctl focus <chat-id> -m <msg-id>       # Jump to specific message
+beepctl focus <chat-id> -d "draft text"   # Pre-fill draft text
+beepctl focus <chat-id> -a /path/to/file  # Pre-fill draft attachment
+```
+
+**Tip:** Use focus with `-a` to send media (images, files) since `send` only supports text:
+
+```bash
+beepctl focus <chat-id> -a /path/to/image.png -d "Check this out!"
+# Then press Enter in Beeper to send
+```
+
+### Archive
+
+```bash
+beepctl archive <chat-id>              # Archive a chat
+beepctl archive <chat-id> --unarchive  # Unarchive a chat
+beepctl archive work                   # Use alias
+beepctl archive <chat-id> --quiet      # No confirmation message
+```
+
+### Aliases
+
+Create shortcuts for frequently used chat IDs:
+
+```bash
+beepctl alias list                    # List all aliases
+beepctl alias add work <chat-id>      # Create alias
+beepctl alias show work               # Show alias value
+beepctl alias remove work             # Remove alias
+beepctl send work "Using alias!"      # Use alias in any command
+```
+
+### Contacts
+
+```bash
+beepctl contacts search <account-id> <query>  # Search contacts on an account
+```
+
+### Download Attachments
+
+Download message attachments (mxc:// URLs):
+
+```bash
+beepctl download <mxc-url>              # Download to current directory
+beepctl download <mxc-url> -o /path     # Save to specific path
+```
+
+### Reminders
+
+Set reminders to follow up on chats:
+
+```bash
+beepctl reminders set <chat-id> 30m      # Remind in 30 minutes
+beepctl reminders set <chat-id> 1h       # Remind in 1 hour
+beepctl reminders set <chat-id> 2d       # Remind in 2 days
+beepctl reminders set <chat-id> tomorrow # Remind tomorrow
+beepctl reminders clear <chat-id>        # Clear reminder
+```
+
 ## Development
 
 ```bash
@@ -162,11 +260,16 @@ src/
 │   ├── alias.ts     # Alias management
 │   ├── archive.ts   # Archive/unarchive chats
 │   ├── chats.ts     # Browse chats
+│   ├── contacts.ts  # Search contacts
+│   ├── download.ts  # Download attachments
+│   ├── focus.ts     # Bring Beeper to foreground
+│   ├── messages.ts  # List messages in a chat
+│   ├── reminders.ts # Chat reminders
 │   ├── search.ts    # Search messages/chats
 │   └── send.ts      # Send messages
 └── lib/             # Core logic
     ├── client.ts    # Beeper API client wrapper
-    ├── config.ts    # Config file management (~/.config/beepcli/)
+    ├── config.ts    # Config file management (~/.config/beepctl/)
     ├── aliases.ts   # Alias resolution utilities
     └── dates.ts     # Relative date parsing
 ```
@@ -185,7 +288,7 @@ src/
 
 Inspired by [beeper-cli](https://github.com/krausefx/beeper-cli) by [@krausefx](https://github.com/krausefx).
 
-The author uses beepcli alongside [clawdbot](https://github.com/blqke/clawdbot).
+The author uses beepctl alongside [clawdbot](https://github.com/blqke/clawdbot).
 
 ## License
 

package/dist/lib/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAKD,wBAAgB,SAAS,IAAI,YAAY,CAkBxC;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAMrD;AAED,wBAAgB,aAAa,IAAI,MAAM,CAEtC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAyCD,wBAAgB,SAAS,IAAI,YAAY,CAqBxC;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAMrD;AAED,wBAAgB,aAAa,IAAI,MAAM,CAEtC"}

package/dist/lib/config.js

@@ -1,14 +1,47 @@
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { join } from "node:path";
-const CONFIG_DIR = join(homedir(), ".config", "beepcli");
+const CONFIG_DIR = join(homedir(), ".config", "beepctl");
 const CONFIG_FILE = join(CONFIG_DIR, "config.json");
+// Legacy config path (before rename to beepctl)
+const LEGACY_CONFIG_DIR = join(homedir(), ".config", "beepcli");
+const LEGACY_CONFIG_FILE = join(LEGACY_CONFIG_DIR, "config.json");
+let migrationDone = false;
+/**
+ * Migrate config from legacy ~/.config/beepcli/ to ~/.config/beepctl/
+ * Runs once per process, copies config and removes legacy directory.
+ */
+function migrateIfNeeded() {
+    if (migrationDone)
+        return;
+    migrationDone = true;
+    // Skip if new config already exists or legacy doesn't exist
+    if (existsSync(CONFIG_FILE) || !existsSync(LEGACY_CONFIG_FILE))
+        return;
+    try {
+        const legacyContent = readFileSync(LEGACY_CONFIG_FILE, "utf-8");
+        const config = JSON.parse(legacyContent);
+        // Create new config directory and save
+        if (!existsSync(CONFIG_DIR)) {
+            mkdirSync(CONFIG_DIR, { recursive: true });
+        }
+        writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
+        // Remove legacy directory
+        rmSync(LEGACY_CONFIG_DIR, { recursive: true });
+        console.error("Migrated config from ~/.config/beepcli/ to ~/.config/beepctl/");
+    }
+    catch {
+        // Silent fail - user can manually migrate if needed
+    }
+}
 export function getConfig() {
     const envToken = process.env.BEEPER_TOKEN;
     const envUrl = process.env.BEEPER_URL;
     if (envToken || envUrl) {
         return { token: envToken, baseUrl: envUrl };
     }
+    // Migrate legacy config if needed
+    migrateIfNeeded();
     if (existsSync(CONFIG_FILE)) {
         try {
             const content = readFileSync(CONFIG_FILE, "utf-8");

package/dist/lib/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAQjC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;AACzD,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;AAEpD,MAAM,UAAU,SAAS;IACxB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;IAC1C,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;IAEtC,IAAI,QAAQ,IAAI,MAAM,EAAE,CAAC;QACxB,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAC7C,CAAC;IAED,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7B,IAAI,CAAC;YACJ,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YACnD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAiB,CAAC;QAC5C,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,EAAE,CAAC;QACX,CAAC;IACF,CAAC;IAED,OAAO,EAAE,CAAC;AACX,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAoB;IAC9C,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7B,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,aAAa;IAC5B,OAAO,WAAW,CAAC;AACpB,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACrF,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAQjC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;AACzD,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;AAEpD,gDAAgD;AAChD,MAAM,iBAAiB,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;AAChE,MAAM,kBAAkB,GAAG,IAAI,CAAC,iBAAiB,EAAE,aAAa,CAAC,CAAC;AAElE,IAAI,aAAa,GAAG,KAAK,CAAC;AAE1B;;;GAGG;AACH,SAAS,eAAe;IACvB,IAAI,aAAa;QAAE,OAAO;IAC1B,aAAa,GAAG,IAAI,CAAC;IAErB,4DAA4D;IAC5D,IAAI,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,kBAAkB,CAAC;QAAE,OAAO;IAEvE,IAAI,CAAC;QACJ,MAAM,aAAa,GAAG,YAAY,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;QAChE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAiB,CAAC;QAEzD,uCAAuC;QACvC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC7B,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5C,CAAC;QACD,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAE5D,0BAA0B;QAC1B,MAAM,CAAC,iBAAiB,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE/C,OAAO,CAAC,KAAK,CAAC,+DAA+D,CAAC,CAAC;IAChF,CAAC;IAAC,MAAM,CAAC;QACR,oDAAoD;IACrD,CAAC;AACF,CAAC;AAED,MAAM,UAAU,SAAS;IACxB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;IAC1C,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;IAEtC,IAAI,QAAQ,IAAI,MAAM,EAAE,CAAC;QACxB,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAC7C,CAAC;IAED,kCAAkC;IAClC,eAAe,EAAE,CAAC;IAElB,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7B,IAAI,CAAC;YACJ,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YACnD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAiB,CAAC;QAC5C,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,EAAE,CAAC;QACX,CAAC;IACF,CAAC;IAED,OAAO,EAAE,CAAC;AACX,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAoB;IAC9C,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7B,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,aAAa;IAC5B,OAAO,WAAW,CAAC;AACpB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "beepctl",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "CLI for Beeper Desktop API - unified messaging from terminal",
   "license": "MIT",
   "type": "module",