10b805c
@@ -448,3 +448,18 @@
Flags: `--root DIR`.
```console
$ forge ui
```
## forge talk
Say something to the forge's own agent, as you, and print what it answers.
The agent works through the forge's MCP with your permissions; a write it
would make is held for your yes. The words are 1 to 20,000 characters
(exit 2 when empty or too long); a 401 exits 3. It waits up to two minutes
for the answer, then says to read it on the feed.
Flags: none.
```console
$ forge talk "what is waiting on me?"
Two pulls are green and wait for your merge: #12 and #15.
```
@@ -1,35 +1,21 @@
/**
 * docs/CLI.md keeps up with the CLI (#7372): every command `forge help`
 * prints has a `## forge <command>` heading there. The help is captured the
 * way a shell sees it — `bun src/cli/main.ts help` as a process — because
 * `main` writes to the real stdout, not to a writer a test can hand it.
 * prints has a `## forge <command>` heading there. The help is rendered
 * in-process: spawning a process made the verdict depend on the machine's load.
 */
import { expect, test } from "bun:test";
import { readFileSync } from "node:fs";
import { tmpdir } from "node:os";
import { printUsage } from "../src/cli/help.ts";
import { createOut } from "../src/cli/out.ts";
const root = new URL("..", import.meta.url).pathname;
const DOC = "docs/CLI.md";
async function help(): Promise<string> {
  const ran = Bun.spawn([process.execPath, "src/cli/main.ts", "help"], {
    cwd: root,
    env: {
      PATH: process.env["PATH"] ?? "",
      HOME: tmpdir(),
      NO_COLOR: "1",
      FORGE_KEYCHAIN: "0",
    },
    stdout: "pipe",
    stderr: "pipe",
  });
  const [stdout, exitCode] = await Promise.all([
    new Response(ran.stdout).text(),
    ran.exited,
  ]);
  expect(exitCode).toBe(0);
  return stdout;
  const lines: string[] = [];
  printUsage({ ...createOut(), line: (t = "") => void lines.push(t) });
  return lines.join("\n").replace(/\x1b\[[0-9;]*m/g, "");
}
/** `  forge sync   [--watch]` → "sync"; the bare `  forge      the local…` → "": a command is one space after `forge`, a description many. */
		@@ -448,3 +448,18 @@ Flags: `--root DIR`.
448	448	```console
449	449	$ forge ui
450	450	```
	451
	452	## forge talk
	453
	454	Say something to the forge's own agent, as you, and print what it answers.
	455	The agent works through the forge's MCP with your permissions; a write it
	456	would make is held for your yes. The words are 1 to 20,000 characters
	457	(exit 2 when empty or too long); a 401 exits 3. It waits up to two minutes
	458	for the answer, then says to read it on the feed.
	459
	460	Flags: none.
	461
	462	```console
	463	$ forge talk "what is waiting on me?"
	464	Two pulls are green and wait for your merge: #12 and #15.
	465	```
		@@ -1,35 +1,21 @@
1	1	/**
2	2	* docs/CLI.md keeps up with the CLI (#7372): every command `forge help`
3		* prints has a `## forge <command>` heading there. The help is captured the
4		* way a shell sees it — `bun src/cli/main.ts help` as a process — because
5		* `main` writes to the real stdout, not to a writer a test can hand it.
	3	* prints has a `## forge <command>` heading there. The help is rendered
	4	* in-process: spawning a process made the verdict depend on the machine's load.
6	5	*/
7	6
8	7	import { expect, test } from "bun:test";
9	8	import { readFileSync } from "node:fs";
10		import { tmpdir } from "node:os";
	9	import { printUsage } from "../src/cli/help.ts";
	10	import { createOut } from "../src/cli/out.ts";
11	11
12	12	const root = new URL("..", import.meta.url).pathname;
13	13	const DOC = "docs/CLI.md";
14	14
15	15	async function help(): Promise<string> {
16		const ran = Bun.spawn([process.execPath, "src/cli/main.ts", "help"], {
17		cwd: root,
18		env: {
19		PATH: process.env["PATH"] ?? "",
20		HOME: tmpdir(),
21		NO_COLOR: "1",
22		FORGE_KEYCHAIN: "0",
23		},
24		stdout: "pipe",
25		stderr: "pipe",
26		});
27		const [stdout, exitCode] = await Promise.all([
28		new Response(ran.stdout).text(),
29		ran.exited,
30		]);
31		expect(exitCode).toBe(0);
32		return stdout;
	16	const lines: string[] = [];
	17	printUsage({ ...createOut(), line: (t = "") => void lines.push(t) });
	18	return lines.join("\n").replace(/\x1b\[[0-9;]*m/g, "");
33	19	}
34	20
35	21	/** ` forge sync [--watch]` → "sync"; the bare ` forge the local…` → "": a command is one space after `forge`, a description many. */