@eliya-oss/agent-slack 0.1.1 → 0.1.3

package/.agents/cli-api.md

@@ -40,6 +40,7 @@ Defaults:
 agent-slack auth login
 agent-slack auth login --profile work --scopes channels:read,channels:history --user-scopes search:read.public,search:read.private
 agent-slack auth login --oauth --client-id CLIENT_ID --client-secret CLIENT_SECRET --auth-url-out /tmp/agent-slack-auth-url
+agent-slack auth login --oauth --client-id CLIENT_ID --client-secret CLIENT_SECRET --no-open
 agent-slack auth status
 agent-slack auth scopes
 agent-slack auth profiles list
@@ -49,6 +50,7 @@ agent-slack auth logout --profile work
 Auth behavior:
 
 - Uses Slack OAuth v2 with a localhost callback.
+- Opens the Slack OAuth URL in the default browser by default. Use `--no-open` to print the URL only, or `--auth-url-out PATH` for headless agents and tests.
 - Bot scopes go in `scope=...`; user scopes go in `user_scope=...`.
 - Stores profiles outside the project directory. The default store is `~/.config/agent-slack/profiles.json`; set `AGENT_SLACK_TOKEN_STORE=keychain` on macOS to keep token secrets in Keychain and only profile metadata on disk.
 - Supports multiple profiles and workspaces.

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @eliya-oss/agent-slack
 
+## 0.1.3
+
+### Patch Changes
+
+- Open Slack OAuth login in the default browser by default.
+
+  Headless flows can still use `--auth-url-out PATH` or `--no-open`, and the CLI now reads its displayed version from package metadata so releases stay in sync.
+
+## 0.1.2
+
+### Patch Changes
+
+- Fix the displayed CLI version and make the human command catalog copy-safe in terminals.
+
 ## 0.1.1
 
 ### Patch Changes

package/README.md

@@ -23,6 +23,8 @@ agent-slack conversation context C123 --include users,threads,permalinks --forma
 agent-slack api call conversations.info --payload '{"channel":"C123"}' --json
 ```
 
+OAuth login opens Slack in your browser. Use `--no-open` to print the URL.
+
 ## Skill
 
 ```bash

package/dist/adapters/localhost-oauth/NodeLocalhostOAuthFlow.js

@@ -1,4 +1,5 @@
 import { randomBytes } from "node:crypto";
+import { spawn } from "node:child_process";
 import { writeFile } from "node:fs/promises";
 import { createServer } from "node:http";
 import { PermissionDenied, SlackApiFailed, UsageError } from "../../domain/errors.js";
@@ -41,6 +42,12 @@ export class NodeLocalhostOAuthFlow {
         if (input.authUrlOut !== undefined) {
             await writeFile(input.authUrlOut, authorizationUrl, "utf8");
         }
+        else if (input.openBrowser !== false) {
+            const opened = await (this.options.openBrowser ?? openSystemBrowser)(authorizationUrl);
+            process.stderr.write(opened
+                ? `Opening Slack OAuth in your browser.\nIf it did not open, visit:\n${authorizationUrl}\n`
+                : `Could not open a browser automatically. Visit this Slack OAuth URL:\n${authorizationUrl}\n`);
+        }
         else {
             process.stderr.write(`Open this Slack OAuth URL:\n${authorizationUrl}\n`);
         }
@@ -161,3 +168,24 @@ const splitScopes = (value) => value === undefined || value.trim() === "" ? [] :
 const closeServer = (server) => {
     server.close();
 };
+const openSystemBrowser = (url) => new Promise((resolve) => {
+    const command = browserCommand(url);
+    const child = spawn(command.file, command.args, {
+        detached: true,
+        stdio: "ignore"
+    });
+    child.once("error", () => resolve(false));
+    child.once("spawn", () => {
+        child.unref();
+        resolve(true);
+    });
+});
+const browserCommand = (url) => {
+    if (process.platform === "darwin") {
+        return { file: "open", args: [url] };
+    }
+    if (process.platform === "win32") {
+        return { file: "cmd", args: ["/c", "start", "", url] };
+    }
+    return { file: "xdg-open", args: [url] };
+};

package/dist/application/commands.js

@@ -210,7 +210,8 @@ const authCommand = async (parsed, services) => {
             userScopes: splitCsv(flagString(parsed, "user-scopes")),
             redirectUri: flagString(parsed, "redirect-uri"),
             authUrlOut: flagString(parsed, "auth-url-out"),
-            timeoutMs: numberFlag(parsed, "timeout-ms")
+            timeoutMs: numberFlag(parsed, "timeout-ms"),
+            openBrowser: !flagBoolean(parsed, "no-open")
         });
         await services.tokenStore.setProfile(profile);
         return { method: "auth.login", profile, stdoutValue: sanitizeProfile(profile) };

package/dist/cli/args.js

@@ -10,7 +10,8 @@ const booleanFlags = new Set([
     "yes",
     "no-cache",
     "inclusive",
-    "oauth"
+    "oauth",
+    "no-open"
 ]);
 export const parseArgs = (argv) => {
     const flags = new Map();

package/dist/cli/metadata.js

@@ -1,6 +1,10 @@
+import { createRequire } from "node:module";
+const require = createRequire(import.meta.url);
+const packageJson = require("../../package.json");
 export const PRIMARY_COMMAND_NAME = "agent-slack";
 export const SHORT_COMMAND_NAME = "aslk";
 export const COMMAND_NAMES = [PRIMARY_COMMAND_NAME, SHORT_COMMAND_NAME];
+export const CLI_VERSION = packageJson.version ?? "0.0.0";
 export const commandMetadata = [
     {
         path: ["describe"],
@@ -29,7 +33,7 @@ export const commandMetadata = [
     {
         path: ["auth", "login"],
         summary: "Create a Slack auth profile with OAuth or a seeded token.",
-        flags: ["--profile", "--oauth", "--client-id", "--client-secret", "--scopes", "--user-scopes", "--redirect-uri", "--auth-url-out", "--timeout-ms", "--token", "--json"],
+        flags: ["--profile", "--oauth", "--client-id", "--client-secret", "--scopes", "--user-scopes", "--redirect-uri", "--auth-url-out", "--timeout-ms", "--no-open", "--token", "--json"],
         safety: "read",
         output: "profile status",
         examples: [
@@ -277,7 +281,7 @@ export const commandMetadata = [
 export const describeAllCommands = () => ({
     name: PRIMARY_COMMAND_NAME,
     aliases: [SHORT_COMMAND_NAME],
-    version: "0.1.0",
+    version: CLI_VERSION,
     commands: commandMetadata
 });
 export const findCommandMetadata = (path) => commandMetadata.find((command) => command.path.join(" ") === path.join(" ")) ?? null;

package/dist/output/human.js

@@ -48,17 +48,15 @@ const renderCommandCatalog = (catalog, paint) => {
     ];
 };
 const renderCommandGroup = (group, paint) => {
-    const width = Math.min(34, Math.max(...group.commands.map((command) => commandSignature(command).length)));
     return [
         paint("yellow", group.title),
         ...group.commands.map((command) => {
-            const signature = pad(commandSignature(command), width);
             const safety = command.safety === "destructive"
                 ? ` ${paint("yellow", "[destructive]")}`
                 : command.safety === "unknown"
                     ? ` ${paint("yellow", "[review]")}`
                     : "";
-            return `  ${paint("cyan", signature)}  ${command.summary}${safety}`;
+            return `  ${paint("cyan", commandSignature(command))} - ${command.summary}${safety}`;
         }),
         ""
     ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eliya-oss/agent-slack",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Slack context CLI for AI agents.",
   "type": "module",
   "packageManager": "pnpm@11.9.0",

package/skills/agent-slack/SKILL.md

@@ -11,7 +11,7 @@ Use `agent-slack` as the Slack context boundary. `aslk` is the short alias. Pref
 
 1. Check availability: `agent-slack describe --json`.
 2. Check auth: `agent-slack auth status --json`.
-3. If auth is missing, ask the user to run OAuth or provide a seeded profile; do not invent credentials.
+3. If auth is missing, ask the user to run `agent-slack auth login --oauth`; it opens Slack OAuth in the browser by default. For headless flows use `--auth-url-out PATH` or `--no-open`.
 4. Use specific read commands before raw API calls.
 5. Use `--json` for bounded results and `--format ndjson` for large context streams.
 6. Read structured errors from stderr; do not parse progress text from stdout.