mirror of
https://github.com/purrgrammer/grimoire.git
synced 2026-04-10 15:36:53 +02:00
52f39a8073
Phase 3 implementation: - Created layout-presets.ts with 3 built-in presets (side-by-side, main-sidebar, grid) - Implemented fillLayoutTemplate() for recursive template filling with window IDs - Added collectWindowIds() for depth-first traversal of layout trees - Created applyPresetToLayout() to reorganize existing windows - Created layout-parser.ts for /layout command argument parsing - Added layout command to man.ts with documentation and examples - Built LayoutViewer component with: * Visual preset gallery with diagrams * Window count validation * Apply preset functionality * Error handling for insufficient windows * Command-line preset specification support - Wired LayoutViewer into WindowRenderer with lazy loading - Added "layout" to AppId type definition - Exposed applyPresetLayout in useGrimoire hook Presets allow users to quickly reorganize multiple windows into common layouts: 50/50 splits, 70/30 main+sidebar, or 2×2 grids. Generated with [Claude Code](https://claude.com/claude-code)
488 lines
21 KiB
TypeScript
488 lines
21 KiB
TypeScript
import { parseReqCommand } from "../lib/req-parser";
|
||
import type { AppId } from "./app";
|
||
|
||
import { parseOpenCommand } from "@/lib/open-parser";
|
||
import { parseProfileCommand } from "@/lib/profile-parser";
|
||
import { parseRelayCommand } from "@/lib/relay-parser";
|
||
import { parseLayoutCommand } from "@/lib/layout-parser";
|
||
import { resolveNip05Batch } from "@/lib/nip05";
|
||
|
||
export interface ManPageEntry {
|
||
name: string;
|
||
section: string;
|
||
synopsis: string;
|
||
description: string;
|
||
options?: { flag: string; description: string }[];
|
||
examples?: string[];
|
||
seeAlso?: string[];
|
||
// Command execution metadata
|
||
appId: AppId;
|
||
category: "Documentation" | "System" | "Nostr";
|
||
argParser?: (args: string[]) => any;
|
||
defaultProps?: any;
|
||
}
|
||
|
||
export const manPages: Record<string, ManPageEntry> = {
|
||
nip: {
|
||
name: "nip",
|
||
section: "1",
|
||
synopsis: "nip <number>",
|
||
description:
|
||
"View a Nostr Implementation Possibility (NIP) specification document. NIPs define the protocol standards and extensions for the Nostr network.",
|
||
options: [
|
||
{
|
||
flag: "<number>",
|
||
description: "The NIP number to view (e.g., 01, 02, 19, B0)",
|
||
},
|
||
],
|
||
examples: [
|
||
"nip 01 View the basic protocol specification",
|
||
"nip 19 View the bech32 encoding specification",
|
||
"nip b0 View the NIP-B0 specification",
|
||
],
|
||
seeAlso: ["nips", "kind", "kinds"],
|
||
appId: "nip",
|
||
category: "Documentation",
|
||
argParser: (args: string[]) => {
|
||
const num = (args[0] || "01").toUpperCase();
|
||
// Pad single digit numbers with leading zero
|
||
const paddedNum = num.length === 1 ? `0${num}` : num;
|
||
return { number: paddedNum };
|
||
},
|
||
defaultProps: { number: "01" },
|
||
},
|
||
|
||
kind: {
|
||
name: "kind",
|
||
section: "1",
|
||
synopsis: "kind <number>",
|
||
description:
|
||
"View information about a specific Nostr event kind. Event kinds define the type and purpose of Nostr events.",
|
||
options: [
|
||
{
|
||
flag: "<number>",
|
||
description: "The kind number to view (e.g., 0, 1, 3, 7)",
|
||
},
|
||
],
|
||
examples: [
|
||
"kind 0 View metadata event kind",
|
||
"kind 1 View short text note kind",
|
||
],
|
||
seeAlso: ["kinds", "nip", "nips"],
|
||
appId: "kind",
|
||
category: "Documentation",
|
||
argParser: (args: string[]) => ({ number: args[0] || "1" }),
|
||
defaultProps: { number: "1" },
|
||
},
|
||
help: {
|
||
name: "help",
|
||
section: "1",
|
||
synopsis: "help",
|
||
description:
|
||
"Display general help information about Grimoire and available commands.",
|
||
seeAlso: ["man", "nip", "kind"],
|
||
appId: "man",
|
||
category: "System",
|
||
defaultProps: { cmd: "help" },
|
||
},
|
||
kinds: {
|
||
name: "kinds",
|
||
section: "1",
|
||
synopsis: "kinds",
|
||
description:
|
||
"Display all Nostr event kinds with rich rendering support in Grimoire. Shows kind numbers, names, descriptions, and links to their defining NIPs.",
|
||
examples: ["kinds View all supported event kinds"],
|
||
seeAlso: ["kind", "nip", "man"],
|
||
appId: "kinds",
|
||
category: "System",
|
||
defaultProps: {},
|
||
},
|
||
nips: {
|
||
name: "nips",
|
||
section: "1",
|
||
synopsis: "nips",
|
||
description:
|
||
"Display all Nostr Implementation Possibilities (NIPs). Shows NIP numbers and titles, with links to view each specification document.",
|
||
examples: ["nips View all NIPs"],
|
||
seeAlso: ["nip", "kinds", "man"],
|
||
appId: "nips",
|
||
category: "Documentation",
|
||
defaultProps: {},
|
||
},
|
||
// debug: {
|
||
// name: "debug",
|
||
// section: "1",
|
||
// synopsis: "debug",
|
||
// description:
|
||
// "Display the current application state for debugging purposes. Shows windows, workspaces, active account, and other internal state in a formatted view.",
|
||
// examples: ["debug View current application state"],
|
||
// seeAlso: ["help"],
|
||
// appId: "debug",
|
||
// category: "System",
|
||
// defaultProps: {},
|
||
// },
|
||
man: {
|
||
name: "man",
|
||
section: "1",
|
||
synopsis: "man <command>",
|
||
description:
|
||
"Display the manual page for a command. Man pages provide detailed documentation including usage, options, and examples.",
|
||
options: [
|
||
{
|
||
flag: "<command>",
|
||
description: "The command to view documentation for",
|
||
},
|
||
],
|
||
examples: [
|
||
"man req View the req command manual",
|
||
"man nip View the nip command manual",
|
||
],
|
||
seeAlso: ["help"],
|
||
appId: "man",
|
||
category: "System",
|
||
argParser: (args: string[]) => ({ cmd: args[0] || "help" }),
|
||
defaultProps: { cmd: "help" },
|
||
},
|
||
req: {
|
||
name: "req",
|
||
section: "1",
|
||
synopsis: "req [options] [relay...]",
|
||
description:
|
||
"Query Nostr relays using filters. Constructs and executes Nostr REQ messages to fetch events matching specified criteria. Supports filtering by kind, author, tags, time ranges, and content search. Use $me and $contacts aliases for queries based on your active account.",
|
||
options: [
|
||
{
|
||
flag: "-k, --kind <number>",
|
||
description:
|
||
"Filter by event kind (e.g., 0=metadata, 1=note, 7=reaction). Supports comma-separated values: -k 1,3,7",
|
||
},
|
||
{
|
||
flag: "-a, --author <npub|hex|nip05|$me|$contacts>",
|
||
description:
|
||
"Filter by author pubkey (supports npub, hex, NIP-05 identifier, bare domain, $me, or $contacts). Supports comma-separated values: -a npub1...,user@domain.com,$me",
|
||
},
|
||
{
|
||
flag: "-l, --limit <number>",
|
||
description: "Maximum number of events to return",
|
||
},
|
||
{
|
||
flag: "-e <id>",
|
||
description:
|
||
"Filter by referenced event ID (#e tag). Supports comma-separated values: -e id1,id2,id3",
|
||
},
|
||
{
|
||
flag: "-p <npub|hex|nip05|$me|$contacts>",
|
||
description:
|
||
"Filter by mentioned pubkey (#p tag, supports npub, hex, NIP-05, bare domain, $me, or $contacts). Supports comma-separated values: -p npub1...,npub2...,$contacts",
|
||
},
|
||
{
|
||
flag: "-P <npub|hex|nip05|$me|$contacts>",
|
||
description:
|
||
"Filter by zap sender (#P tag, supports npub, hex, NIP-05, bare domain, $me, or $contacts). Supports comma-separated values: -P npub1...,npub2...,$me. Useful for finding zaps sent by specific users.",
|
||
},
|
||
{
|
||
flag: "-t <hashtag>",
|
||
description:
|
||
"Filter by hashtag (#t tag). Supports comma-separated values: -t nostr,bitcoin,lightning",
|
||
},
|
||
{
|
||
flag: "-d <identifier>",
|
||
description:
|
||
"Filter by d-tag identifier (replaceable events). Supports comma-separated values: -d article1,article2",
|
||
},
|
||
{
|
||
flag: "-T, --tag <letter> <value>",
|
||
description:
|
||
"Filter by any single-letter tag (#<letter>). Supports comma-separated values: --tag a val1,val2. Works with any tag (a, r, g, L, etc.)",
|
||
},
|
||
{
|
||
flag: "--since <time>",
|
||
description:
|
||
"Events after timestamp (unix timestamp, relative: 30s, 1m, 2h, 7d, 2w, 3mo, 1y, or 'now')",
|
||
},
|
||
{
|
||
flag: "--until <time>",
|
||
description:
|
||
"Events before timestamp (unix timestamp, relative: 30s, 1m, 2h, 7d, 2w, 3mo, 1y, or 'now')",
|
||
},
|
||
{
|
||
flag: "--search <text>",
|
||
description: "Search event content for text (relay-dependent)",
|
||
},
|
||
{
|
||
flag: "--close-on-eose",
|
||
description:
|
||
"Close connection after EOSE (End Of Stored Events). By default, streams stay open for real-time updates.",
|
||
},
|
||
{
|
||
flag: "[relay...]",
|
||
description:
|
||
"Relay URLs to query (wss://relay.com or shorthand: relay.com)",
|
||
},
|
||
],
|
||
examples: [
|
||
"req -k 1 -l 20 Get 20 recent notes (auto-selects optimal relays via NIP-65)",
|
||
"req -k 1,3,7 -l 50 Get notes, contact lists, and reactions",
|
||
"req -k 0 -a fiatjaf.com Get profile (queries author's outbox relays)",
|
||
"req -k 1 -a verbiricha@habla.news Get notes from NIP-05 identifier",
|
||
"req -k 1 -a dergigi.com Get notes from bare domain (resolves to _@dergigi.com)",
|
||
"req -k 1 -a fiatjaf.com,dergigi.com Get notes from multiple authors (balances across outbox relays)",
|
||
"req -a $me Get all your events (queries your outbox relays)",
|
||
"req -k 1 -a $contacts --since 24h Get notes from contacts (queries their outbox relays)",
|
||
"req -k 1 -a $contacts --since 7d Get notes from contacts in last week",
|
||
"req -k 1 -a $contacts --since 3mo Get notes from contacts in last 3 months",
|
||
"req -k 1 -a $contacts --since 1y Get notes from contacts in last year",
|
||
"req -p $me -k 1,7 Get replies and reactions to you (queries your inbox relays)",
|
||
"req -k 1 -a $me -a $contacts Get notes from you and contacts",
|
||
"req -k 9735 -p $me --since 7d Get zaps you received (queries your inbox)",
|
||
"req -k 9735 -P $me --since 7d Get zaps you sent",
|
||
"req -k 9735 -P $contacts Get zaps sent by your contacts",
|
||
"req -k 1 -p verbiricha@habla.news Get notes mentioning user (queries their inbox)",
|
||
"req -k 1 --since 1h relay.damus.io Get notes from last hour (manual relay override)",
|
||
"req -k 1 --since 7d --until now Get notes from last week up to now",
|
||
"req -k 1 --close-on-eose Get recent notes and close after EOSE",
|
||
"req -t nostr,grimoire,bitcoin -l 50 Get 50 events tagged #nostr, #grimoire, or #bitcoin",
|
||
"req --tag a 30023:7fa56f5d6962ab1e3cd424e758c3002b8665f7b0d8dcee9fe9e288d7751ac194:grimoire Get events referencing addressable event (#a tag)",
|
||
"req -T r grimoire.rocks Get events referencing URL (#r tag)",
|
||
"req -k 30023 --tag d badges,grimoire Get specific replaceable events by d-tag",
|
||
"req --search bitcoin -k 1 Search notes for 'bitcoin'",
|
||
"req -k 1 theforest.nostr1.com relay.damus.io Query specific relays (overrides auto-selection)",
|
||
],
|
||
seeAlso: ["kind", "nip"],
|
||
appId: "req",
|
||
category: "Nostr",
|
||
argParser: async (args: string[]) => {
|
||
const parsed = parseReqCommand(args);
|
||
|
||
// Add default limit of 50 if not specified
|
||
if (!parsed.filter.limit) {
|
||
parsed.filter.limit = 50;
|
||
}
|
||
|
||
// Resolve NIP-05 identifiers if present
|
||
const allNip05 = [
|
||
...(parsed.nip05Authors || []),
|
||
...(parsed.nip05PTags || []),
|
||
...(parsed.nip05PTagsUppercase || []),
|
||
];
|
||
|
||
if (allNip05.length > 0) {
|
||
const resolved = await resolveNip05Batch(allNip05);
|
||
|
||
// Add resolved authors to filter
|
||
if (parsed.nip05Authors) {
|
||
for (const nip05 of parsed.nip05Authors) {
|
||
const pubkey = resolved.get(nip05);
|
||
if (pubkey) {
|
||
if (!parsed.filter.authors) parsed.filter.authors = [];
|
||
parsed.filter.authors.push(pubkey);
|
||
}
|
||
}
|
||
}
|
||
|
||
// Add resolved #p tags to filter
|
||
if (parsed.nip05PTags) {
|
||
for (const nip05 of parsed.nip05PTags) {
|
||
const pubkey = resolved.get(nip05);
|
||
if (pubkey) {
|
||
if (!parsed.filter["#p"]) parsed.filter["#p"] = [];
|
||
parsed.filter["#p"].push(pubkey);
|
||
}
|
||
}
|
||
}
|
||
|
||
// Add resolved #P tags to filter
|
||
if (parsed.nip05PTagsUppercase) {
|
||
for (const nip05 of parsed.nip05PTagsUppercase) {
|
||
const pubkey = resolved.get(nip05);
|
||
if (pubkey) {
|
||
if (!parsed.filter["#P"]) parsed.filter["#P"] = [];
|
||
parsed.filter["#P"].push(pubkey);
|
||
}
|
||
}
|
||
}
|
||
}
|
||
|
||
return parsed;
|
||
},
|
||
defaultProps: { filter: { kinds: [1], limit: 50 } },
|
||
},
|
||
open: {
|
||
name: "open",
|
||
section: "1",
|
||
synopsis: "open <identifier>",
|
||
description:
|
||
"Open a detailed view of a Nostr event. Accepts multiple identifier formats including bech32-encoded IDs, hex IDs, and address pointers. Displays event metadata, rendered content, and raw JSON.",
|
||
options: [
|
||
{
|
||
flag: "<identifier>",
|
||
description: "Event identifier in any supported format (see examples)",
|
||
},
|
||
],
|
||
examples: [
|
||
"open nevent1qgs8lft0t45k92c78n2zfe6ccvqzhpn977cd3h8wnl579zxhw5dvr9qqyz4nf2hlglhzhezygl5x2fdsg332fyd9q0p8ja7kvn0g53e0edzyxa32zg8 Open event with relay hints",
|
||
"open naddr1qvzqqqrkvupzpn6956apxcad0mfp8grcuugdysg44eepex68h50t73zcathmfs49qy88wumn8ghj7mn0wvhxcmmv9uq3wamnwvaz7tmjv4kxz7fwdehhxarj9e3xzmny9uq3wamnwvaz7tmjv4kxz7fwwpexjmtpdshxuet59uq3qamnwvaz7tmwdaehgu3wd4hk6tcpz9mhxue69uhkummnw3ezuamfdejj7qghwaehxw309a3xjarrda5kuetj9eek7cmfv9kz7qg4waehxw309aex2mrp0yhxgctdw4eju6t09uq3samnwvaz7tmxd9k8getj9ehx7um5wgh8w6twv5hszymhwden5te0danxvcmgv95kutnsw43z7qgawaehxw309ahx7um5wghxy6t5vdhkjmn9wgh8xmmrd9skctcpr9mhxue69uhhyetvv9ujuumwdae8gtnnda3kjctv9uqsuamnwvaz7tmev9382tndv5hsz9nhwden5te0wfjkccte9e3k76twdaeju6t09uq3vamnwvaz7tmjv4kxz7fwxvuns6np9eu8j730qqjr2vehvyenvdtr94nrzetr956rgctr94skvvfs95eryep3x3snwve389nxy97cjwx Open addressable event",
|
||
"open 30023:7fa56f5d6962ab1e3cd424e758c3002b8665f7b0d8dcee9fe9e288d7751ac194:grimoire Open by address pointer (kind:pubkey:d-tag)",
|
||
],
|
||
seeAlso: ["req", "kind"],
|
||
appId: "open",
|
||
category: "Nostr",
|
||
argParser: (args: string[]) => {
|
||
const parsed = parseOpenCommand(args);
|
||
return parsed;
|
||
},
|
||
},
|
||
profile: {
|
||
name: "profile",
|
||
section: "1",
|
||
synopsis: "profile <identifier>",
|
||
description:
|
||
"Open a detailed view of a Nostr user profile. Accepts multiple identifier formats including npub, nprofile, hex pubkeys, and NIP-05 identifiers (including bare domains). Displays profile metadata, inbox/outbox relays, and raw JSON.",
|
||
options: [
|
||
{
|
||
flag: "<identifier>",
|
||
description: "User identifier in any supported format (see examples)",
|
||
},
|
||
],
|
||
examples: [
|
||
"profile fiatjaf.com Open profile by NIP-05 identifier",
|
||
"profile nprofile1qyd8wumn8ghj7urewfsk66ty9enxjct5dfskvtnrdakj7qgmwaehxw309a6xsetxdaex2um59ehx7um5wgcjucm0d5hsz9mhwden5te0veex2mnn9ehx7um5wgcjucm0d5hszxrhwden5te0ve5kcar9wghxummnw3ezuamfdejj7qpq07jk7htfv243u0x5ynn43scq9wrxtaasmrwwa8lfu2ydwag6cx2q0al9p4 Open profile with relay hints",
|
||
"profile 3bf0c63fcb93463407af97a5e5ee64fa883d107ef9e558472c4eb9aaaefa459d Open profile by hex pubkey (64 chars)",
|
||
"profile dergigi.com Open profile by domain (resolves to _@dergigi.com)",
|
||
"profile jack@cash.app Open profile using NIP-05",
|
||
],
|
||
seeAlso: ["open", "req"],
|
||
appId: "profile",
|
||
category: "Nostr",
|
||
argParser: async (args: string[]) => {
|
||
const parsed = await parseProfileCommand(args);
|
||
return parsed;
|
||
},
|
||
},
|
||
encode: {
|
||
name: "encode",
|
||
section: "1",
|
||
synopsis: "encode <type> <value> [--relay <url>] [--author <pubkey>]",
|
||
description:
|
||
"Encode hex values into Nostr bech32 identifiers (npub, note, nevent, nprofile, naddr). Follows nak-style syntax for explicit, unambiguous encoding.",
|
||
options: [
|
||
{
|
||
flag: "<type>",
|
||
description: "Encoding type: npub, note, nevent, nprofile, naddr",
|
||
},
|
||
{
|
||
flag: "<value>",
|
||
description:
|
||
"Hex value to encode (pubkey, event ID, or kind:pubkey:d-tag)",
|
||
},
|
||
{
|
||
flag: "--relay, -r",
|
||
description: "Add relay hint (can be specified multiple times)",
|
||
},
|
||
{
|
||
flag: "--author, -a",
|
||
description: "Add author pubkey (nevent only)",
|
||
},
|
||
],
|
||
examples: [
|
||
"encode npub 3bf0c63fcb93463407af97a5e5ee64fa883d107ef9e558472c4eb9aaaefa459d Encode pubkey to npub",
|
||
"encode nprofile 3bf0c63fcb93463407af97a5e5ee64fa883d107ef9e558472c4eb9aaaefa459d --relay wss://theforest.nostr1.com Encode profile with relay",
|
||
"encode note 5c83da77af1dec6d7289834998ad7aafbd9e2191396d75ec3cc27f5a77226f36 Encode event ID to note",
|
||
"encode nevent 5c83da77af1dec6d7289834998ad7aafbd9e2191396d75ec3cc27f5a77226f36 --relay wss://theforest.nostr1.com --author 3bf0c63fcb93463407af97a5e5ee64fa883d107ef9e558472c4eb9aaaefa459d Encode event with metadata",
|
||
"encode naddr 30023:3bf0c63fcb93463407af97a5e5ee64fa883d107ef9e558472c4eb9aaaefa459d:my-article --relay wss://theforest.nostr1.com Encode addressable event",
|
||
],
|
||
seeAlso: ["decode"],
|
||
appId: "encode",
|
||
category: "Nostr",
|
||
argParser: (args: string[]) => {
|
||
return { args };
|
||
},
|
||
},
|
||
decode: {
|
||
name: "decode",
|
||
section: "1",
|
||
synopsis: "decode <bech32-identifier>",
|
||
description:
|
||
"Decode Nostr bech32 identifiers (npub, note, nevent, nprofile, naddr, nsec) into their component parts. Display decoded data, edit relay hints, re-encode with updates, and open events or profiles directly.",
|
||
options: [
|
||
{
|
||
flag: "<bech32-identifier>",
|
||
description: "Any Nostr bech32 identifier to decode",
|
||
},
|
||
],
|
||
examples: [
|
||
"decode nprofile1qyd8wumn8ghj7urewfsk66ty9enxjct5dfskvtnrdakj7qgmwaehxw309a6xsetxdaex2um59ehx7um5wgcjucm0d5hsz9mhwden5te0veex2mnn9ehx7um5wgcjucm0d5hszxrhwden5te0ve5kcar9wghxummnw3ezuamfdejj7qpq07jk7htfv243u0x5ynn43scq9wrxtaasmrwwa8lfu2ydwag6cx2q0al9p4 Decode nprofile with relay hints",
|
||
"decode nevent1qgs8lft0t45k92c78n2zfe6ccvqzhpn977cd3h8wnl579zxhw5dvr9qqyz4nf2hlglhzhezygl5x2fdsg332fyd9q0p8ja7kvn0g53e0edzyxa32zg8 Decode nevent showing ID, relays, author",
|
||
"decode naddr1qvzqqqrkvupzpn6956apxcad0mfp8grcuugdysg44eepex68h50t73zcathmfs49qy88wumn8ghj7mn0wvhxcmmv9uq3wamnwvaz7tmjv4kxz7fwdehhxarj9e3xzmny9uq3wamnwvaz7tmjv4kxz7fwwpexjmtpdshxuet59uq3qamnwvaz7tmwdaehgu3wd4hk6tcpz9mhxue69uhkummnw3ezuamfdejj7qghwaehxw309a3xjarrda5kuetj9eek7cmfv9kz7qg4waehxw309aex2mrp0yhxgctdw4eju6t09uq3samnwvaz7tmxd9k8getj9ehx7um5wgh8w6twv5hszymhwden5te0danxvcmgv95kutnsw43z7qgawaehxw309ahx7um5wghxy6t5vdhkjmn9wgh8xmmrd9skctcpr9mhxue69uhhyetvv9ujuumwdae8gtnnda3kjctv9uqsuamnwvaz7tmev9382tndv5hsz9nhwden5te0wfjkccte9e3k76twdaeju6t09uq3vamnwvaz7tmjv4kxz7fwxvuns6np9eu8j730qqjr2vehvyenvdtr94nrzetr956rgctr94skvvfs95eryep3x3snwve389nxy97cjwx Decode naddr showing kind, pubkey, identifier",
|
||
],
|
||
seeAlso: ["encode"],
|
||
appId: "decode",
|
||
category: "Nostr",
|
||
argParser: (args: string[]) => {
|
||
return { args };
|
||
},
|
||
},
|
||
relay: {
|
||
name: "relay",
|
||
section: "1",
|
||
synopsis: "relay <url>",
|
||
description:
|
||
"View detailed information about a Nostr relay. Displays NIP-11 relay information document including connection status, supported NIPs, operator details, limitations, and software information.",
|
||
options: [
|
||
{
|
||
flag: "<url>",
|
||
description:
|
||
"Relay WebSocket URL (wss:// or ws://) or domain (auto-adds wss://)",
|
||
},
|
||
],
|
||
examples: [
|
||
"relay wss://relay.damus.io View relay information",
|
||
"relay nos.lol View relay capabilities",
|
||
],
|
||
seeAlso: ["req", "profile"],
|
||
appId: "relay",
|
||
category: "Nostr",
|
||
argParser: (args: string[]) => {
|
||
const parsed = parseRelayCommand(args);
|
||
return parsed;
|
||
},
|
||
},
|
||
conn: {
|
||
name: "conn",
|
||
section: "1",
|
||
synopsis: "conn",
|
||
description:
|
||
"Monitor all relay connections in the pool. Displays real-time connection status, authentication state, pending auth challenges, relay notices, and connection statistics. Manage auth preferences per relay (always/never/ask).",
|
||
examples: ["conn View all relay connections and auth status"],
|
||
seeAlso: ["relay", "req"],
|
||
appId: "conn",
|
||
category: "System",
|
||
defaultProps: {},
|
||
},
|
||
layout: {
|
||
name: "layout",
|
||
section: "1",
|
||
synopsis: "layout [preset-name]",
|
||
description:
|
||
"Apply a preset layout to reorganize windows in the current workspace. Presets provide common layout arrangements like side-by-side splits, main+sidebar configurations, and grid layouts. Running without arguments shows all available presets.",
|
||
options: [
|
||
{
|
||
flag: "[preset-name]",
|
||
description: "Preset layout to apply (side-by-side, main-sidebar, grid)",
|
||
},
|
||
],
|
||
examples: [
|
||
"layout View all available presets",
|
||
"layout side-by-side Apply 50/50 horizontal split (2 windows)",
|
||
"layout main-sidebar Apply 70/30 horizontal split (2 windows)",
|
||
"layout grid Apply 2×2 grid layout (4 windows)",
|
||
],
|
||
seeAlso: ["man"],
|
||
appId: "layout",
|
||
category: "System",
|
||
argParser: (args: string[]) => {
|
||
const result = parseLayoutCommand(args);
|
||
return result;
|
||
},
|
||
},
|
||
};
|