@aholbreich/agent-skills 0.5.0 → 0.6.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 0.6.0 - 2026-05-07
+
+Added:
+
+- Shared `ATLASSIAN_CHROME_PROFILE` and `ATLASSIAN_CHROME_DEBUG_PORT` support so Jira and Confluence fetchers can reuse one dedicated Atlassian SSO browser session.
+- Browser fetchers now open the requested target URL in a new tab when reusing an existing DevTools browser.
+
 ## 0.5.0 - 2026-05-07
 
 Added:

package/README.md

@@ -177,6 +177,17 @@ jira-browser-fetch
 confluence-browser-fetch
 ```
 
+## Reuse one Atlassian browser login
+
+To avoid separate Jira and Confluence SSO prompts, use one shared automation profile and DevTools port for both fetchers:
+
+```bash
+export ATLASSIAN_CHROME_PROFILE="$HOME/.local/share/atlassian-browser-fetch-chrome"
+export ATLASSIAN_CHROME_DEBUG_PORT=9223
+```
+
+Skill-specific variables such as `JIRA_CHROME_PROFILE` or `CONFLUENCE_CHROME_PROFILE` still override the shared profile when needed.
+
 ## Jira examples
 
 Fetch one issue:

package/SECURITY.md

@@ -23,7 +23,7 @@ They do **not** require you to paste API tokens or cookies into chat.
 - Do not commit fetched Jira/Confluence exports or attachments to a public repository.
 - Review generated `attachments.json` manifests before sharing; they may contain private URLs and filenames.
 - Chrome remote debugging is configured for `127.0.0.1`; do not expose it to a network interface.
-- Use dedicated browser profiles for fetch automation.
+- Use dedicated browser profiles for fetch automation. If reusing SSO between Jira and Confluence, share only a dedicated automation profile via `ATLASSIAN_CHROME_PROFILE`, not your everyday browser profile.
 - The default attachment download cap is `5mb`; skipped large attachments are still referenced in `attachments.json`.
 
 ## Attachment size limits

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aholbreich/agent-skills",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Handcrafted Agent Skills for browser-authenticated Jira and Confluence ingestion, LLM wiki workflows, and developer automation.",
   "license": "MIT",
   "type": "commonjs",

package/skills/confluence-browser-fetch/SKILL.md

@@ -49,8 +49,9 @@ Important options:
 2. If the user gives a title, ask for the space key or use `--cql`.
 3. Show the command before running it.
 4. If Chrome opens, ask the user to complete SSO in that browser window.
-5. Verify saved files.
-6. If this is an LLM wiki ingest, process the saved `raw/confluence/...` material into `wiki/` per the project `AGENTS.md`.
+5. To share one Atlassian SSO login with `jira-browser-fetch`, use `ATLASSIAN_CHROME_PROFILE` plus `ATLASSIAN_CHROME_DEBUG_PORT` (or matching `--profile-dir` and `--port`) for both tools.
+6. Verify saved files.
+7. If this is an LLM wiki ingest, process the saved `raw/confluence/...` material into `wiki/` per the project `AGENTS.md`.
 
 Example:
 

package/skills/confluence-browser-fetch/references/usage.md

@@ -106,16 +106,27 @@ By default, pages with matching local `metadata.json` Confluence `version.number
 |---|---|
 | `CONFLUENCE_SITE` | Default Atlassian site, e.g. `https://example.atlassian.net` |
 | `CONFLUENCE_RAW_DIR` | Default output raw directory |
-| `CONFLUENCE_CHROME_DEBUG_PORT` | Chrome DevTools port, default `9224` |
+| `CONFLUENCE_CHROME_DEBUG_PORT` | Chrome DevTools port, default `9224`; overrides `ATLASSIAN_CHROME_DEBUG_PORT` |
+| `ATLASSIAN_CHROME_DEBUG_PORT` | Shared Chrome DevTools port for Jira and Confluence browser fetchers. If only `ATLASSIAN_CHROME_PROFILE` is set, Confluence defaults to shared port `9223`. |
 | `CONFLUENCE_FETCH_WAIT_SEC` | Wait timeout, default `900` |
 | `CONFLUENCE_MAX_SEARCH_RESULTS` | Max CQL pages, default `200` |
 | `CONFLUENCE_MAX_ATTACHMENT_SIZE` / `CONFLUENCE_MAX_ATTACHMENT_BYTES` | Max attachment download size, default `5mb`; skipped files are listed in `attachments.json` |
 | `CONFLUENCE_RETRIES` | Retry count for transient HTTP errors, default `3` |
 | `CONFLUENCE_REQUEST_TIMEOUT_SEC` | Per-request timeout, default `60` |
 | `CONFLUENCE_SKIP_UNCHANGED` | Set to `0` to disable default skip-unchanged behavior |
-| `CONFLUENCE_CHROME_PROFILE` | Dedicated Chrome profile dir |
+| `CONFLUENCE_CHROME_PROFILE` | Dedicated Chrome profile dir; overrides `ATLASSIAN_CHROME_PROFILE` |
+| `ATLASSIAN_CHROME_PROFILE` | Shared browser profile dir for Jira and Confluence browser fetchers |
 | `CHROME` / `CHROMIUM` | Browser executable path override |
 
+To reuse one Atlassian SSO login across Jira and Confluence fetches, set a shared profile and port for both tools:
+
+```bash
+export ATLASSIAN_CHROME_PROFILE="$HOME/.local/share/atlassian-browser-fetch-chrome"
+export ATLASSIAN_CHROME_DEBUG_PORT=9223
+```
+
+When reusing an existing DevTools browser on the configured port, the script opens the requested Confluence URL in a new tab before verifying the REST session.
+
 ## Output Files
 
 For each page:

package/skills/confluence-browser-fetch/scripts/confluence-browser-fetch.js

@@ -30,8 +30,8 @@ Options:
   --retries N              HTTP retry count for transient failures (default: 3)
   --request-timeout SEC    Per-request timeout (default: 60)
   --wait SEC               Wait time for SSO/session (default: 900)
-  --port PORT              Chrome DevTools port (default: 9224)
-  --profile-dir DIR        Chrome profile dir (default: ~/.local/share/confluence-browser-fetch-chrome)
+  --port PORT              Chrome DevTools port (default: CONFLUENCE_CHROME_DEBUG_PORT, ATLASSIAN_CHROME_DEBUG_PORT, or 9224)
+  --profile-dir DIR        Chrome profile dir (default: CONFLUENCE_CHROME_PROFILE, ATLASSIAN_CHROME_PROFILE, or ~/.local/share/confluence-browser-fetch-chrome)
   --help                   Show this help
 
 Examples:
@@ -46,9 +46,9 @@ Examples:
 const opts = {
   site: process.env.CONFLUENCE_SITE || '',
   rawDir: process.env.CONFLUENCE_RAW_DIR || path.resolve(process.cwd(), 'raw'),
-  port: Number(process.env.CONFLUENCE_CHROME_DEBUG_PORT || 9224),
+  port: Number(process.env.CONFLUENCE_CHROME_DEBUG_PORT || process.env.ATLASSIAN_CHROME_DEBUG_PORT || (process.env.ATLASSIAN_CHROME_PROFILE ? 9223 : 9224)),
   waitSec: Number(process.env.CONFLUENCE_FETCH_WAIT_SEC || 900),
-  profileDir: process.env.CONFLUENCE_CHROME_PROFILE || path.join(os.homedir(), '.local/share/confluence-browser-fetch-chrome'),
+  profileDir: process.env.CONFLUENCE_CHROME_PROFILE || process.env.ATLASSIAN_CHROME_PROFILE || path.join(os.homedir(), '.local/share/confluence-browser-fetch-chrome'),
   maxSearchResults: Number(process.env.CONFLUENCE_MAX_SEARCH_RESULTS || 200),
   retries: Number(process.env.CONFLUENCE_RETRIES || 3),
   requestTimeoutSec: Number(process.env.CONFLUENCE_REQUEST_TIMEOUT_SEC || 60),
@@ -116,6 +116,21 @@ async function waitDevtools() {
   throw new Error('Chrome DevTools endpoint did not start');
 }
 
+async function openDevtoolsTab(url) {
+  if (!url) return false;
+  const endpointUrl = `http://127.0.0.1:${opts.port}/json/new?${encodeURIComponent(url)}`;
+  for (const init of [{ method: 'PUT' }, {}]) {
+    try {
+      const res = await fetch(endpointUrl, init);
+      if (res.ok) {
+        await sleep(500);
+        return true;
+      }
+    } catch {}
+  }
+  return false;
+}
+
 function isExecutable(file) {
   try { fs.accessSync(file, fs.constants.X_OK); return true; } catch { return false; }
 }
@@ -181,6 +196,12 @@ async function ensureBrowser(openUrl) {
     launchChrome(openUrl || wikiBase);
   } else {
     console.log(`Reusing Chrome DevTools on port ${opts.port}`);
+    const targetUrl = openUrl || wikiBase;
+    if (targetUrl) {
+      const opened = await openDevtoolsTab(targetUrl);
+      if (opened) console.log(`Opened target URL in reused browser: ${targetUrl}`);
+      else console.warn(`Could not open target URL through DevTools; continuing with existing tabs.`);
+    }
   }
   await waitDevtools();
 }

package/skills/jira-browser-fetch/SKILL.md

@@ -55,7 +55,8 @@ Use this skill for user requests like:
 1. Identify raw directory.
 2. Run the script and show the command first.
 3. If Chrome opens, ask the user to complete SSO in that browser window.
-4. Verify saved files.
+4. To share one Atlassian SSO login with `confluence-browser-fetch`, use `ATLASSIAN_CHROME_PROFILE` plus `ATLASSIAN_CHROME_DEBUG_PORT` (or matching `--profile-dir` and `--port`) for both tools.
+5. Verify saved files.
 
 Example:
 

package/skills/jira-browser-fetch/references/usage.md

@@ -121,13 +121,24 @@ Default max attachment download size is `5mb`. Use `--max-attachment-size unlimi
 |---|---|
 | `JIRA_SERVER` | Default Jira base URL |
 | `JIRA_RAW_DIR` | Default output raw directory |
-| `JIRA_CHROME_DEBUG_PORT` | Chrome DevTools port, default `9223` |
+| `JIRA_CHROME_DEBUG_PORT` | Chrome DevTools port, default `9223`; overrides `ATLASSIAN_CHROME_DEBUG_PORT` |
+| `ATLASSIAN_CHROME_DEBUG_PORT` | Shared Chrome DevTools port for Jira and Confluence browser fetchers |
 | `JIRA_FETCH_WAIT_SEC` | Wait timeout per issue, default `900` |
 | `JIRA_MAX_SEARCH_RESULTS` | Max issues added per JQL or backlog search, default `1000` |
 | `JIRA_MAX_ATTACHMENT_SIZE` / `JIRA_MAX_ATTACHMENT_BYTES` | Max attachment download size, default `5mb`; skipped files are listed in `attachments.json` |
-| `JIRA_CHROME_PROFILE` | Dedicated Chrome profile dir |
+| `JIRA_CHROME_PROFILE` | Dedicated Chrome profile dir; overrides `ATLASSIAN_CHROME_PROFILE` |
+| `ATLASSIAN_CHROME_PROFILE` | Shared browser profile dir for Jira and Confluence browser fetchers |
 | `CHROME` / `CHROMIUM` | Browser executable path override |
 
+To reuse one Atlassian SSO login across Jira and Confluence fetches, set a shared profile and port for both tools:
+
+```bash
+export ATLASSIAN_CHROME_PROFILE="$HOME/.local/share/atlassian-browser-fetch-chrome"
+export ATLASSIAN_CHROME_DEBUG_PORT=9223
+```
+
+When reusing an existing DevTools browser on the configured port, the script opens the requested Jira URL in a new tab before verifying the REST session.
+
 ## Example user requests
 
 Agents should invoke this skill for requests such as:

package/skills/jira-browser-fetch/scripts/jira-browser-fetch.js

@@ -35,8 +35,8 @@ Options:
   --max-attachment-size S  Skip attachment downloads larger than S (default: 5mb; use unlimited to disable)
   --prefix A,B,C           Only fetch referenced keys with these project prefixes
   --wait SEC               Wait time for SSO/session per issue (default: 900)
-  --port PORT              Chrome DevTools port (default: 9223)
-  --profile-dir DIR        Chrome profile dir (default: ~/.local/share/jira-browser-fetch-chrome)
+  --port PORT              Chrome DevTools port (default: JIRA_CHROME_DEBUG_PORT, ATLASSIAN_CHROME_DEBUG_PORT, or 9223)
+  --profile-dir DIR        Chrome profile dir (default: JIRA_CHROME_PROFILE, ATLASSIAN_CHROME_PROFILE, or ~/.local/share/jira-browser-fetch-chrome)
   --no-attachments         Do not download Jira attachments
   --no-html                Do not save browser HTML
   --no-xml                 Do not save Jira XML issue view
@@ -54,9 +54,9 @@ Examples:
 const opts = {
   server: process.env.JIRA_SERVER || '',
   rawDir: process.env.JIRA_RAW_DIR || path.resolve(process.cwd(), 'raw'),
-  port: Number(process.env.JIRA_CHROME_DEBUG_PORT || 9223),
+  port: Number(process.env.JIRA_CHROME_DEBUG_PORT || process.env.ATLASSIAN_CHROME_DEBUG_PORT || 9223),
   waitSec: Number(process.env.JIRA_FETCH_WAIT_SEC || 900),
-  profileDir: process.env.JIRA_CHROME_PROFILE || path.join(os.homedir(), '.local/share/jira-browser-fetch-chrome'),
+  profileDir: process.env.JIRA_CHROME_PROFILE || process.env.ATLASSIAN_CHROME_PROFILE || path.join(os.homedir(), '.local/share/jira-browser-fetch-chrome'),
   connected: false,
   depth: undefined,
   scanText: false,
@@ -128,6 +128,21 @@ async function waitDevtools() {
   throw new Error('Chrome DevTools endpoint did not start');
 }
 
+async function openDevtoolsTab(url) {
+  if (!url) return false;
+  const endpointUrl = `http://127.0.0.1:${opts.port}/json/new?${encodeURIComponent(url)}`;
+  for (const init of [{ method: 'PUT' }, {}]) {
+    try {
+      const res = await fetch(endpointUrl, init);
+      if (res.ok) {
+        await sleep(500);
+        return true;
+      }
+    } catch {}
+  }
+  return false;
+}
+
 function isExecutable(file) {
   try { fs.accessSync(file, fs.constants.X_OK); return true; } catch { return false; }
 }
@@ -504,6 +519,11 @@ async function ensureBrowser(browseUrl) {
     launchChrome(browseUrl);
   } else {
     console.log(`Reusing Chrome DevTools on port ${opts.port}`);
+    if (browseUrl) {
+      const opened = await openDevtoolsTab(browseUrl);
+      if (opened) console.log(`Opened target URL in reused browser: ${browseUrl}`);
+      else console.warn(`Could not open target URL through DevTools; continuing with existing tabs.`);
+    }
   }
   await waitDevtools();
 }