gh-axi 0.1.20 → 0.1.22

package/README.md

@@ -14,6 +14,24 @@ GitHub CLI for agents — designed with [AXI](https://github.com/kunchenguid/axi
 Wraps the official `gh` cli with token-efficient TOON output, contextual next-step suggestions, and structured error handling.
 Built for autonomous agents that interact with GitHub via shell execution.
 
+## Benchmarks
+
+Agent ergonomics is measurable.
+The [axi benchmark](https://axi.md) runs the same 17 real-world GitHub tasks (issue triage, PR review prep, CI failure investigation, and more) through 5 GitHub interface setups - 5 repeats each, with `claude-sonnet-4-6` as the agent and an LLM judge scoring task success.
+
+gh-axi posts the lowest input tokens, cost, and duration of all 5 conditions, and is the only one to pass every run:
+
+| Condition                  | Avg Input Tokens | Avg Cost/Task | Avg Duration | Avg Turns | Success  |
+| -------------------------- | ---------------- | ------------- | ------------ | --------- | -------- |
+| **gh-axi**                 | **46,462**       | **$0.050**    | **15.7s**    | **3**     | **100%** |
+| gh CLI (raw)               | 47,076           | $0.054        | 17.4s        | 3         | 86%      |
+| GitHub MCP code execution  | 137,409          | $0.101        | 43.4s        | 7         | 84%      |
+| GitHub MCP + ToolSearch    | 153,621          | $0.147        | 41.1s        | 8         | 82%      |
+| GitHub MCP (eager schemas) | 175,757          | $0.148        | 34.2s        | 6         | 87%      |
+
+Against raw `gh` - the very CLI this tool wraps - that is 100% vs 86% task success at 7% lower cost.
+Against the GitHub MCP server it is 66% cheaper, with 74% fewer input tokens and half the turns.
+
 ## Quick Start
 
 Install the gh-axi skill in the [Agent Skills](https://agentskills.io) format with [`npx skills`](https://github.com/vercel-labs/skills):
@@ -27,6 +45,7 @@ The skill teaches your agent to run gh-axi through `npx -y gh-axi`, so the CLI c
 You still need [`gh`](https://cli.github.com/) installed and authenticated via `gh auth login` (Node 20+ required).
 
 The skill is not a user-facing slash command (`user-invocable: false`).
+Its frontmatter also includes Hermes Agent metadata (`metadata.hermes`) so Hermes can categorize it as a `devops` skill for GitHub, git, CI, pull requests, and releases.
 Just ask for anything that touches GitHub - filing issues, reviewing PRs, checking CI runs, cutting releases - and the agent loads the skill on its own when it recognizes the task.
 
 `-g` installs the skill for all projects (`~/.claude/skills/`, for example); drop it to install for the current project only (`.claude/skills/`).
@@ -70,6 +89,9 @@ gh-axi run view --job 789012 --log-failed # show failed log lines for one job
 gh-axi setup hooks              # install optional agent session hooks
 ```
 
+For multi-line issue, PR, review, or comment text, write Markdown to a UTF-8 file and pass `--body-file <path>` anywhere `--body` is accepted.
+For releases, `--body` and `--body-file` are aliases for release notes, alongside `--notes` and `--notes-file`.
+
 Long `run view --log` and `run view --log-failed` output shows the last 20,000 characters so CI failures stay visible.
 When truncation happens, gh-axi best-effort saves the complete log to a temp file, includes it as `full_log`, and prints a `help:` hint telling agents to grep that file for earlier context.
 
@@ -97,6 +119,7 @@ Repository targeting is command-first too:
 
 - `gh-axi issue list -R owner/name`
 - `gh-axi issue list --repo owner/name`
+- `gh-axi issue list --repo=owner/name`
 - `gh-axi run list -R owner/name`
 - `gh-axi search issues "login bug" --repo owner/name`
 
@@ -108,13 +131,13 @@ When a command also needs a destination repository, use a dedicated flag for it:
 
 ```sh
 pnpm run build       # Compile TypeScript to dist/
-pnpm run build:skill # Regenerate skills/gh-axi/SKILL.md from shared CLI guidance
+pnpm run build:skill # Regenerate skills/gh-axi/SKILL.md from shared skill source
 pnpm run dev         # Run CLI directly with tsx
 pnpm test            # Run tests with vitest
 pnpm run test:watch  # Run tests in watch mode
 ```
 
-The committed `skills/gh-axi/SKILL.md` is generated by `pnpm run build:skill`; `pnpm test` fails if it drifts from the shared CLI guidance.
+The committed `skills/gh-axi/SKILL.md` is generated by `pnpm run build:skill`; `pnpm test` fails if it drifts from the shared CLI guidance or generated skill frontmatter.
 The npm package includes `skills/gh-axi/`, so published releases ship the same installable Agent Skill documented in Quick Start.
 
 ## License

package/dist/src/args.d.ts

@@ -1,12 +1,12 @@
-/** Get a flag's value without modifying the args array. */
+/** Get a flag's value from --flag value or --flag=value without modifying args. */
 export declare function getFlag(args: string[], name: string): string | undefined;
-/** Get a flag's value and remove both the flag and value from args. */
+/** Get a flag's value from --flag value or --flag=value and remove it from args. */
 export declare function takeFlag(args: string[], flag: string): string | undefined;
 /** Check if a boolean flag is present. */
 export declare function hasFlag(args: string[], flag: string): boolean;
 /** Check if a boolean flag is present and remove it from args. */
 export declare function takeBoolFlag(args: string[], flag: string): boolean;
-/** Collect all values for a repeatable flag. */
+/** Collect all values for a repeatable flag in --flag value or --flag=value form. */
 export declare function getAllFlags(args: string[], flag: string): string[];
 /** Get the first positional arg (non-flag) starting from startIndex. */
 export declare function getPositional(args: string[], startIndex: number): string | undefined;

package/dist/src/args.js

@@ -1,19 +1,40 @@
-import { AxiError } from './errors.js';
-/** Get a flag's value without modifying the args array. */
+import { AxiError } from "./errors.js";
+function flagEqualsPrefix(flag) {
+    return `${flag}=`;
+}
+/** Get a flag's value from --flag value or --flag=value without modifying args. */
 export function getFlag(args, name) {
-    const idx = args.indexOf(name);
-    if (idx === -1 || idx + 1 >= args.length)
-        return undefined;
-    return args[idx + 1];
+    const equalsPrefix = flagEqualsPrefix(name);
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === name) {
+            if (i + 1 >= args.length)
+                return undefined;
+            return args[i + 1];
+        }
+        if (arg.startsWith(equalsPrefix)) {
+            return arg.slice(equalsPrefix.length);
+        }
+    }
+    return undefined;
 }
-/** Get a flag's value and remove both the flag and value from args. */
+/** Get a flag's value from --flag value or --flag=value and remove it from args. */
 export function takeFlag(args, flag) {
-    const idx = args.indexOf(flag);
-    if (idx === -1)
-        return undefined;
-    const val = args[idx + 1];
-    args.splice(idx, 2);
-    return val;
+    const equalsPrefix = flagEqualsPrefix(flag);
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === flag) {
+            const val = args[i + 1];
+            args.splice(i, 2);
+            return val;
+        }
+        if (arg.startsWith(equalsPrefix)) {
+            const val = arg.slice(equalsPrefix.length);
+            args.splice(i, 1);
+            return val;
+        }
+    }
+    return undefined;
 }
 /** Check if a boolean flag is present. */
 export function hasFlag(args, flag) {
@@ -27,21 +48,26 @@ export function takeBoolFlag(args, flag) {
     args.splice(idx, 1);
     return true;
 }
-/** Collect all values for a repeatable flag. */
+/** Collect all values for a repeatable flag in --flag value or --flag=value form. */
 export function getAllFlags(args, flag) {
     const result = [];
+    const equalsPrefix = flagEqualsPrefix(flag);
     for (let i = 0; i < args.length; i++) {
-        if (args[i] === flag && i + 1 < args.length) {
+        const arg = args[i];
+        if (arg === flag && i + 1 < args.length) {
             result.push(args[i + 1]);
             i++;
         }
+        else if (arg.startsWith(equalsPrefix)) {
+            result.push(arg.slice(equalsPrefix.length));
+        }
     }
     return result;
 }
 /** Get the first positional arg (non-flag) starting from startIndex. */
 export function getPositional(args, startIndex) {
     for (let i = startIndex; i < args.length; i++) {
-        if (!args[i].startsWith('--'))
+        if (!args[i].startsWith("--"))
             return args[i];
     }
     return undefined;
@@ -49,17 +75,17 @@ export function getPositional(args, startIndex) {
 /** Parse and validate a required numeric argument. */
 export function requireNumber(raw, label) {
     if (!raw)
-        throw new AxiError(`Missing ${label} number`, 'VALIDATION_ERROR');
+        throw new AxiError(`Missing ${label} number`, "VALIDATION_ERROR");
     const n = parseInt(raw, 10);
     if (isNaN(n))
-        throw new AxiError(`Invalid ${label} number: ${raw}`, 'VALIDATION_ERROR');
+        throw new AxiError(`Invalid ${label} number: ${raw}`, "VALIDATION_ERROR");
     return n;
 }
 /** Find the first numeric positional arg, remove it from args, and return it as a number. */
 export function takeNumber(args, label) {
     const raw = args.find((a) => /^\d+$/.test(a));
     if (!raw)
-        throw new AxiError(`Missing ${label} number`, 'VALIDATION_ERROR');
+        throw new AxiError(`Missing ${label} number`, "VALIDATION_ERROR");
     args.splice(args.indexOf(raw), 1);
     return Number(raw);
 }

package/dist/src/args.js.map

@@ -1 +1 @@
-{"version":3,"file":"args.js","sourceRoot":"","sources":["../../src/args.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../../src/args.ts"],"names":[],"mappings":"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"}

package/dist/src/body.d.ts

@@ -1,9 +1,22 @@
+interface TakeBodyOptions {
+    required?: boolean;
+    inlineFlags?: string[];
+    fileFlags?: string[];
+    valueBoundaryFlags?: string[];
+    label?: string;
+    suggestions?: string[];
+}
 /**
- * Shared body cleaning and truncation for all entity types.
+ * Resolve a command body from inline text or a UTF-8 file and remove the flags.
  *
- * Cleanups are only applied when content needs truncation.
- * When --full is used, the raw body is returned as-is.
+ * Optional bodies accept at most one source. Required bodies enforce exactly
+ * one source and raise validation errors for missing, conflicting, or
+ * unreadable input.
  */
+export declare function takeBody(args: string[], options: TakeBodyOptions & {
+    required: true;
+}): string;
+export declare function takeBody(args: string[], options?: TakeBodyOptions): string | undefined;
 /** Clean up a body string to reduce token cost before truncation. */
 export declare function cleanBody(text: string): string;
 /**
@@ -12,3 +25,4 @@ export declare function cleanBody(text: string): string;
  * Returns the raw body when it fits within maxLen.
  */
 export declare function truncateBody(body: unknown, maxLen?: number): string;
+export {};

package/dist/src/body.js

@@ -1,24 +1,118 @@
-/**
- * Shared body cleaning and truncation for all entity types.
- *
- * Cleanups are only applied when content needs truncation.
- * When --full is used, the raw body is returned as-is.
- */
+import { readFileSync } from "node:fs";
+import { AxiError } from "./errors.js";
+function defaultSuggestions(label) {
+    return [
+        `Use --body "..." for inline ${label}, or --body-file <path> for markdown from a file`,
+    ];
+}
+function isMissingValue(value) {
+    return value === undefined || value.trim() === "";
+}
+function isValueBoundary(arg, flags) {
+    if (arg === undefined)
+        return false;
+    return flags.some((flag) => arg === flag || arg.startsWith(`${flag}=`));
+}
+function takeFlagMatches(args, flags, valueBoundaryFlags) {
+    const matches = [];
+    for (let index = 0; index < args.length; index++) {
+        const arg = args[index];
+        let matched = false;
+        for (const flag of flags) {
+            const equalsPrefix = `${flag}=`;
+            if (arg === flag) {
+                const next = args[index + 1];
+                const value = next !== undefined && !isValueBoundary(next, valueBoundaryFlags)
+                    ? next
+                    : undefined;
+                const consumeCount = value === undefined ? 1 : 2;
+                args.splice(index, consumeCount);
+                index--;
+                matches.push({ flag, value });
+                matched = true;
+                break;
+            }
+            if (arg.startsWith(equalsPrefix)) {
+                args.splice(index, 1);
+                index--;
+                matches.push({ flag, value: arg.slice(equalsPrefix.length) });
+                matched = true;
+                break;
+            }
+        }
+        if (matched)
+            continue;
+    }
+    return matches;
+}
+function readBodyFile(flag, path, suggestions) {
+    try {
+        return readFileSync(path, "utf8");
+    }
+    catch (error) {
+        const code = error && typeof error === "object" && "code" in error
+            ? String(error.code)
+            : "UNKNOWN";
+        if (code === "ENOENT") {
+            throw new AxiError(`${flag} path not found: ${path}`, "VALIDATION_ERROR", suggestions);
+        }
+        if (code === "EISDIR") {
+            throw new AxiError(`${flag} must point to a readable UTF-8 file, not a directory: ${path}`, "VALIDATION_ERROR", suggestions);
+        }
+        throw new AxiError(`Could not read ${flag} path: ${path} (${code})`, "VALIDATION_ERROR", suggestions);
+    }
+}
+export function takeBody(args, options = {}) {
+    const inlineFlags = options.inlineFlags ?? ["--body"];
+    const fileFlags = options.fileFlags ?? ["--body-file"];
+    const valueBoundaryFlags = [
+        ...new Set([
+            ...inlineFlags,
+            ...fileFlags,
+            ...(options.valueBoundaryFlags ?? []),
+        ]),
+    ];
+    const label = options.label ?? "body";
+    const suggestions = options.suggestions ?? defaultSuggestions(label);
+    const inlineMatches = takeFlagMatches(args, inlineFlags, valueBoundaryFlags);
+    const fileMatches = takeFlagMatches(args, fileFlags, valueBoundaryFlags);
+    const matches = [...inlineMatches, ...fileMatches];
+    if (matches.length === 0) {
+        if (options.required) {
+            throw new AxiError(`${inlineFlags[0]} or ${fileFlags[0]} is required`, "VALIDATION_ERROR", suggestions);
+        }
+        return undefined;
+    }
+    if (matches.length > 1) {
+        throw new AxiError(`Use only one ${label} source: ${matches.map((m) => m.flag).join(", ")} were provided`, "VALIDATION_ERROR", suggestions);
+    }
+    const match = matches[0];
+    const value = match.value;
+    if (isMissingValue(value)) {
+        const noun = fileFlags.includes(match.flag) ? "path" : "text";
+        throw new AxiError(`${match.flag} requires ${noun}`, "VALIDATION_ERROR", suggestions);
+    }
+    const resolvedValue = value ?? "";
+    if (fileFlags.includes(match.flag)) {
+        return readBodyFile(match.flag, resolvedValue, suggestions);
+    }
+    return resolvedValue;
+}
 /** Clean up a body string to reduce token cost before truncation. */
 export function cleanBody(text) {
     // Normalize GitHub PR/issue URLs to short references
-    let s = text.replace(/\[([^\]]+)\]\(https:\/\/github\.com\/[^/]+\/[^/]+\/pull\/(\d+)\)/g, '[$1](PR#$2)');
-    s = s.replace(/\[([^\]]+)\]\(https:\/\/github\.com\/[^/]+\/[^/]+\/issues\/(\d+)\)/g, '[$1](Issue#$2)');
-    s = s.replace(/(?<!\()https:\/\/github\.com\/[^/]+\/[^/]+\/pull\/(\d+)/g, 'PR#$1');
-    s = s.replace(/(?<!\()https:\/\/github\.com\/[^/]+\/[^/]+\/issues\/(\d+)/g, 'Issue#$1');
+    let s = text.replace(/\[([^\]]+)\]\(https:\/\/github\.com\/[^/]+\/[^/]+\/pull\/(\d+)\)/g, "[$1](PR#$2)");
+    s = s.replace(/\[([^\]]+)\]\(https:\/\/github\.com\/[^/]+\/[^/]+\/issues\/(\d+)\)/g, "[$1](Issue#$2)");
+    s = s.replace(/(?<!\()https:\/\/github\.com\/[^/]+\/[^/]+\/pull\/(\d+)/g, "PR#$1");
+    s = s.replace(/(?<!\()https:\/\/github\.com\/[^/]+\/[^/]+\/issues\/(\d+)/g, "Issue#$1");
     // Strip markdown image embeds: ![alt](url) → [image: alt]
-    s = s.replace(/!\[([^\]]*)\]\([^)]+\)/g, (_m, alt) => alt ? `[image: ${alt}]` : '[image]');
+    s = s.replace(/!\[([^\]]*)\]\([^)]+\)/g, (_m, alt) => alt ? `[image: ${alt}]` : "[image]");
     // Strip long URLs (>80 chars) in markdown links: [text](longurl) → [text]
-    s = s.replace(/\[([^\]]+)\]\(([^)]{80,})\)/g, '[$1]');
+    s = s.replace(/\[([^\]]+)\]\(([^)]{80,})\)/g, "[$1]");
     // Strip standalone long URLs (>100 chars) not in markdown
-    s = s.replace(/(?<!\()https?:\/\/\S{100,}/g, '[long URL removed]');
+    s = s.replace(/(?<!\()https?:\/\/\S{100,}/g, "[long URL removed]");
     // Collapse email-style quoted blocks (lines starting with >) to a summary
-    s = s.replace(/(^|\n)(>\s?[^\n]*\n?){3,}/gm, '$1[quoted text removed]\n');
+    s = s.replace(/(^|\n)(>\s?[^\n]*\n?){3,}/gm, "$1[quoted text removed]\n");
     return s;
 }
 /**
@@ -27,18 +121,24 @@ export function cleanBody(text) {
  * Returns the raw body when it fits within maxLen.
  */
 export function truncateBody(body, maxLen = 500) {
-    if (typeof body !== 'string' || !body)
-        return '';
+    if (typeof body !== "string" || !body)
+        return "";
     if (body.length <= maxLen)
         return body;
     const cleaned = cleanBody(body);
     if (cleaned.length <= maxLen) {
         // Cleanup made it fit, but content was modified — offer --full for the original
         if (cleaned !== body) {
-            return cleaned + '\n(cleaned, ' + body.length + ' chars original — use --full to see original)';
+            return (cleaned +
+                "\n(cleaned, " +
+                body.length +
+                " chars original — use --full to see original)");
         }
         return cleaned;
     }
-    return cleaned.slice(0, maxLen) + '\n... (truncated, ' + cleaned.length + ' chars total — use --full to see complete body)';
+    return (cleaned.slice(0, maxLen) +
+        "\n... (truncated, " +
+        cleaned.length +
+        " chars total — use --full to see complete body)");
 }
 //# sourceMappingURL=body.js.map

package/dist/src/body.js.map

@@ -1 +1 @@
-{"version":3,"file":"body.js","sourceRoot":"","sources":["../../src/body.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,qEAAqE;AACrE,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,qDAAqD;IACrD,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,mEAAmE,EAAE,aAAa,CAAC,CAAC;IACzG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,qEAAqE,EAAE,gBAAgB,CAAC,CAAC;IACvG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,0DAA0D,EAAE,OAAO,CAAC,CAAC;IACnF,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,4DAA4D,EAAE,UAAU,CAAC,CAAC;IACxF,0DAA0D;IAC1D,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,yBAAyB,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,GAAG,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC3F,0EAA0E;IAC1E,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,8BAA8B,EAAE,MAAM,CAAC,CAAC;IACtD,0DAA0D;IAC1D,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,6BAA6B,EAAE,oBAAoB,CAAC,CAAC;IACnE,0EAA0E;IAC1E,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,6BAA6B,EAAE,2BAA2B,CAAC,CAAC;IAC1E,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,IAAa,EAAE,MAAM,GAAG,GAAG;IACtD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACjD,IAAI,IAAI,CAAC,MAAM,IAAI,MAAM;QAAE,OAAO,IAAI,CAAC;IACvC,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,OAAO,CAAC,MAAM,IAAI,MAAM,EAAE,CAAC;QAC7B,gFAAgF;QAChF,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,OAAO,OAAO,GAAG,cAAc,GAAG,IAAI,CAAC,MAAM,GAAG,+CAA+C,CAAC;QAClG,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG,oBAAoB,GAAG,OAAO,CAAC,MAAM,GAAG,iDAAiD,CAAC;AAC9H,CAAC"}
+{"version":3,"file":"body.js","sourceRoot":"","sources":["../../src/body.ts"],"names":[],"mappings":"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"}

package/dist/src/cli.d.ts

@@ -4,6 +4,6 @@ type MainOptions = {
     argv?: string[];
     stdout?: CliStdout;
 };
-export declare const TOP_HELP = "usage: gh-axi [command] [args] [flags]\ncommands[11]:\n  (none)=dashboard, issue, pr, run, workflow, release, repo, label, search, api, setup\nflags[3]:\n  -R/--repo <OWNER/NAME> (after command), --help, -v/-V/--version\nexamples:\n  gh-axi\n  gh-axi issue list --state open\n  gh-axi issue list -R owner/name\n  gh-axi issue list --repo owner/name\n  gh-axi pr view 42\n  gh-axi setup hooks\n";
+export declare const TOP_HELP = "usage: gh-axi [command] [args] [flags]\ncommands[11]:\n  (none)=dashboard, issue, pr, run, workflow, release, repo, label, search, api, setup\nflags[3]:\n  -R/--repo <OWNER/NAME> (after command), accepts space or equals form, --help, -v/-V/--version\nexamples:\n  gh-axi\n  gh-axi issue list --state open\n  gh-axi issue list -R owner/name\n  gh-axi issue list --repo=owner/name\n  gh-axi pr view 42\n  gh-axi setup hooks\n";
 export declare function main(options?: MainOptions): Promise<void>;
 export {};

package/dist/src/cli.js

@@ -20,12 +20,12 @@ export const TOP_HELP = `usage: gh-axi [command] [args] [flags]
 commands[11]:
   (none)=dashboard, issue, pr, run, workflow, release, repo, label, search, api, setup
 flags[3]:
-  -R/--repo <OWNER/NAME> (after command), --help, -v/-V/--version
+  -R/--repo <OWNER/NAME> (after command), accepts space or equals form, --help, -v/-V/--version
 examples:
   gh-axi
   gh-axi issue list --state open
   gh-axi issue list -R owner/name
-  gh-axi issue list --repo owner/name
+  gh-axi issue list --repo=owner/name
   gh-axi pr view 42
   gh-axi setup hooks
 `;
@@ -95,6 +95,10 @@ function parseRepoContextArgs(command, args) {
             index++;
             continue;
         }
+        if (arg.startsWith("-R=") && arg.length > 3) {
+            repoFlag = arg.slice(3);
+            continue;
+        }
         if (arg === "--repo" && index + 1 < args.length) {
             const value = args[index + 1];
             repoFlag = value;
@@ -104,6 +108,13 @@ function parseRepoContextArgs(command, args) {
             index++;
             continue;
         }
+        if (arg.startsWith("--repo=") && arg.length > "--repo=".length) {
+            repoFlag = arg.slice("--repo=".length);
+            if (command === "search") {
+                stripped.push(arg);
+            }
+            continue;
+        }
         stripped.push(arg);
     }
     return { repoFlag, strippedArgs: stripped };

package/dist/src/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,WAAW,EAAoB,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAE/D,MAAM,CAAC,MAAM,WAAW,GACtB,2GAA2G,CAAC;AAC9G,MAAM,OAAO,GAAG,kBAAkB,EAAE,CAAC;AASrC,MAAM,CAAC,MAAM,QAAQ,GAAG;;;;;;;;;;;;CAYvB,CAAC;AAEF,MAAM,YAAY,GAA2B;IAC3C,KAAK,EAAE,UAAU;IACjB,EAAE,EAAE,OAAO;IACX,GAAG,EAAE,QAAQ;IACb,QAAQ,EAAE,aAAa;IACvB,OAAO,EAAE,YAAY;IACrB,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,WAAW;IACnB,GAAG,EAAE,QAAQ;IACb,KAAK,EAAE,UAAU;CAClB,CAAC;AAIF,MAAM,QAAQ,GAA8B;IAC1C,KAAK,EAAE,eAAe,CAAC,OAAO,EAAE,YAAY,CAAC;IAC7C,EAAE,EAAE,eAAe,CAAC,IAAI,EAAE,SAAS,CAAC;IACpC,GAAG,EAAE,eAAe,CAAC,KAAK,EAAE,UAAU,CAAC;IACvC,QAAQ,EAAE,eAAe,CAAC,UAAU,EAAE,eAAe,CAAC;IACtD,OAAO,EAAE,eAAe,CAAC,SAAS,EAAE,cAAc,CAAC;IACnD,IAAI,EAAE,eAAe,CAAC,MAAM,EAAE,WAAW,CAAC;IAC1C,KAAK,EAAE,eAAe,CAAC,OAAO,EAAE,YAAY,CAAC;IAC7C,MAAM,EAAE,eAAe,CAAC,QAAQ,EAAE,aAAa,CAAC;IAChD,GAAG,EAAE,eAAe,CAAC,KAAK,EAAE,UAAU,CAAC;IACvC,KAAK,EAAE,YAAY;CACpB,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,UAAuB,EAAE;IAClD,MAAM,SAAS,CAA0B;QACvC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/C,WAAW,EAAE,WAAW;QACxB,OAAO,EAAE,OAAO;QAChB,YAAY,EAAE,QAAQ;QACtB,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrD,IAAI,EAAE,eAAe,CAAC,SAAS,EAAE,WAAW,CAAC;QAC7C,QAAQ,EAAE,QAAQ;QAClB,cAAc,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC;QAClD,cAAc,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,CACpC,WAAW,CAAC,oBAAoB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC;KAC5D,CAAC,CAAC;AACL,CAAC;AAED,SAAS,kBAAkB;IACzB,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAErD,KAAK,MAAM,SAAS,IAAI;QACtB,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC;QAChC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC;KACvC,EAAE,CAAC;QACF,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC3B,SAAS;QACX,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAEzD,CAAC;QACF,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpE,OAAO,MAAM,CAAC,OAAO,CAAC;QACxB,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,eAAe,CACtB,OAA2B,EAC3B,OAAkB;IAElB,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CACnB,OAAO,CAAC,oBAAoB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;AACnE,CAAC;AAED,SAAS,oBAAoB,CAC3B,OAA2B,EAC3B,IAAc;IAEd,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,QAA4B,CAAC;IAEjC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;QACjD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QACxB,IAAI,GAAG,KAAK,IAAI,IAAI,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YAC5C,QAAQ,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;YAC3B,KAAK,EAAE,CAAC;YACR,SAAS;QACX,CAAC;QAED,IAAI,GAAG,KAAK,QAAQ,IAAI,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YAChD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;YAE9B,QAAQ,GAAG,KAAK,CAAC;YAEjB,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;gBACzB,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAC5B,CAAC;YAED,KAAK,EAAE,CAAC;YACR,SAAS;QACX,CAAC;QAED,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC;AAC9C,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/src/commands/issue.d.ts

@@ -1,4 +1,4 @@
 import type { RepoContext } from "../context.js";
-export declare const ISSUE_HELP = "usage: gh-axi issue <subcommand> [flags]\nsubcommands[14]:\n  list, view <number>, create, edit <number>, close <number>, reopen <number>, comment <number>, delete <number>, lock <number>, unlock <number>, pin <number>, unpin <number>, transfer <number>, subissue <add|remove|list>\nflags{list}:\n  --state <open|closed|all>, --label <name>, --assignee <login>, --author <login>, --milestone <name>, --sort <created|updated|comments>, --limit <n> (default 30), --fields <a,b,c>\nflags{view}:\n  --comments, --full (show complete body without truncation)\nflags{create}:\n  --title <text> (required), --body <text>, --assignee <login>, --label <name>, --milestone <name>, --type <name>\nflags{edit}:\n  --title, --body, --add-label, --remove-label, --add-assignee, --remove-assignee, --milestone, --type <name>, --no-type\nflags{close}:\n  --reason <completed|not_planned>, --comment <text>\nflags{comment}:\n  --body <text> (required)\nflags{transfer}:\n  --to-repo <owner/name> (required)\nsubissue:\n  add <parent> <child> [<child> ...], remove <parent> <child>, list <parent>\nexamples:\n  gh-axi issue list --state closed --label bug\n  gh-axi issue view 42 --comments\n  gh-axi issue create --title \"Fix login\" --body \"Steps to reproduce...\"\n  gh-axi issue close 42 --reason completed\n  gh-axi issue transfer 42 -R source/repo --to-repo dest/repo\n  gh-axi issue subissue add 16 20 101 125\n  gh-axi issue subissue list 16";
+export declare const ISSUE_HELP = "usage: gh-axi issue <subcommand> [flags]\nsubcommands[14]:\n  list, view <number>, create, edit <number>, close <number>, reopen <number>, comment <number>, delete <number>, lock <number>, unlock <number>, pin <number>, unpin <number>, transfer <number>, subissue <add|remove|list>\nflags{list}:\n  --state <open|closed|all>, --label <name>, --assignee <login>, --author <login>, --milestone <name>, --sort <created|updated|comments>, --limit <n> (default 30), --fields <a,b,c>\nflags{view}:\n  --comments, --full (show complete body without truncation)\nflags{create}:\n  --title <text> (required), --body <text> or --body-file <path>, --assignee <login>, --label <name>, --milestone <name>, --type <name>\nflags{edit}:\n  --title, --body <text> or --body-file <path>, --add-label, --remove-label, --add-assignee, --remove-assignee, --milestone, --type <name>, --no-type\nflags{close}:\n  --reason <completed|not_planned>, --comment <text>\nflags{comment}:\n  --body <text> or --body-file <path> (required)\nflags{transfer}:\n  --to-repo <owner/name> (required)\nsubissue:\n  add <parent> <child> [<child> ...], remove <parent> <child>, list <parent>\nexamples:\n  gh-axi issue list --state closed --label bug\n  gh-axi issue view 42 --comments\n  gh-axi issue create --title \"Fix login\" --body \"Steps to reproduce...\"\n  gh-axi issue comment 42 --body-file comment.md\n  gh-axi issue close 42 --reason completed\n  gh-axi issue transfer 42 -R source/repo --to-repo dest/repo\n  gh-axi issue subissue add 16 20 101 125\n  gh-axi issue subissue list 16";
 export declare const SUBISSUE_HELP = "usage: gh-axi issue subissue <add|remove|list> <parent> [child...]\nsubcommands[3]:\n  add <parent> <child> [<child> ...], remove <parent> <child>, list <parent>\nexamples:\n  gh-axi issue subissue add 16 20 101 125\n  gh-axi issue subissue remove 16 101\n  gh-axi issue subissue list 16";
 export declare function issueCommand(args: string[], ctx?: RepoContext): Promise<string>;

package/dist/src/commands/issue.js

@@ -1,8 +1,8 @@
 import { ghJson, ghExec, ghRaw } from "../gh.js";
 import { AxiError, mapGhError } from "../errors.js";
 import { getSuggestions } from "../suggestions.js";
-import { getFlag, hasFlag, getPositional, requireNumber, takeFlag, takeBoolFlag, } from "../args.js";
-import { truncateBody } from "../body.js";
+import { hasFlag, getFlag, getPositional, requireNumber, takeFlag, takeBoolFlag, } from "../args.js";
+import { takeBody, truncateBody } from "../body.js";
 import { parseFields } from "../fields.js";
 import { formatCountLine } from "../format.js";
 import { field, pluck, joinArray, relativeTime, lower, custom, renderList, renderDetail, renderHelp, renderError, renderOutput, } from "../toon.js";
@@ -17,13 +17,13 @@ flags{list}:
 flags{view}:
   --comments, --full (show complete body without truncation)
 flags{create}:
-  --title <text> (required), --body <text>, --assignee <login>, --label <name>, --milestone <name>, --type <name>
+  --title <text> (required), --body <text> or --body-file <path>, --assignee <login>, --label <name>, --milestone <name>, --type <name>
 flags{edit}:
-  --title, --body, --add-label, --remove-label, --add-assignee, --remove-assignee, --milestone, --type <name>, --no-type
+  --title, --body <text> or --body-file <path>, --add-label, --remove-label, --add-assignee, --remove-assignee, --milestone, --type <name>, --no-type
 flags{close}:
   --reason <completed|not_planned>, --comment <text>
 flags{comment}:
-  --body <text> (required)
+  --body <text> or --body-file <path> (required)
 flags{transfer}:
   --to-repo <owner/name> (required)
 subissue:
@@ -32,6 +32,7 @@ examples:
   gh-axi issue list --state closed --label bug
   gh-axi issue view 42 --comments
   gh-axi issue create --title "Fix login" --body "Steps to reproduce..."
+  gh-axi issue comment 42 --body-file comment.md
   gh-axi issue close 42 --reason completed
   gh-axi issue transfer 42 -R source/repo --to-repo dest/repo
   gh-axi issue subissue add 16 20 101 125
@@ -334,7 +335,7 @@ async function createIssue(args, ctx) {
     const title = getFlag(args, "--title");
     if (!title)
         throw new AxiError("--title is required", "VALIDATION_ERROR");
-    const body = getFlag(args, "--body");
+    const body = takeBody(args);
     const assignee = getFlag(args, "--assignee");
     const label = getFlag(args, "--label");
     const milestone = getFlag(args, "--milestone");
@@ -346,7 +347,7 @@ async function createIssue(args, ctx) {
         resolvedType = await resolveIssueType(typeName, ctx);
     }
     const ghArgs = ["issue", "create", "--title", title];
-    if (body)
+    if (body !== undefined)
         ghArgs.push("--body", body);
     if (assignee)
         ghArgs.push("--assignee", assignee);
@@ -388,7 +389,7 @@ async function createIssue(args, ctx) {
 async function editIssue(args, ctx) {
     const num = requireNumber(getPositional(args, 1), "issue");
     const title = getFlag(args, "--title");
-    const body = getFlag(args, "--body");
+    const body = takeBody(args);
     const addLabel = getFlag(args, "--add-label");
     const removeLabel = getFlag(args, "--remove-label");
     const addAssignee = getFlag(args, "--add-assignee");
@@ -405,7 +406,7 @@ async function editIssue(args, ctx) {
     const ghArgs = ["issue", "edit", String(num)];
     if (title)
         ghArgs.push("--title", title);
-    if (body)
+    if (body !== undefined)
         ghArgs.push("--body", body);
     if (addLabel)
         ghArgs.push("--add-label", addLabel);
@@ -525,9 +526,7 @@ async function reopenIssue(args, ctx) {
 }
 async function commentOnIssue(args, ctx) {
     const num = requireNumber(getPositional(args, 1), "issue");
-    const body = getFlag(args, "--body");
-    if (!body)
-        throw new AxiError("--body is required", "VALIDATION_ERROR");
+    const body = takeBody(args, { required: true });
     await ghExec(["issue", "comment", String(num), "--body", body], ctx);
     // Fetch the latest comment
     const issue = await ghJson(["issue", "view", String(num), "--json", "comments"], ctx);