[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10,"_11":12},"actionData","errors","root",{"_271":-5,"_274":275,"_276":277},"routes/shell",{"_40":41,"_270":-5,"_271":-5,"_272":273},"routes/repo",{"_33":-7,"_34":35,"_36":37,"_38":39,"_40":41,"_42":31,"_43":31,"_44":31,"_45":31,"_46":31,"_47":31,"_48":49,"_50":49,"_51":31,"_52":-7,"_53":-7,"_54":55,"_56":57,"_58":59,"_60":-5,"_61":62,"_63":64,"_65":66,"_67":68},"routes/repo.blob",{"_13":14,"_15":16,"_17":18,"_19":20,"_21":14,"_22":23,"_24":-5,"_25":26,"_27":28,"_28":29,"_30":31,"_32":14},"ref","2e4ce3444d6e9f58c82615ac6f48d892a5cd5c73","path","apps/host/src/cli.ts","oid","4a4914b1dab8f8c4c36c5364e8a08c53c07e3eae","size",12078,"commit","mounts",[],"source","plain",{"_13":14,"_15":16},"kind","text","#!/usr/bin/env bun\nimport { resolve } from \"node:path\";\nimport { parseArgs } from \"node:util\";\n\nimport type { ChannelInfo, ChatId, Event } from \"@ace/channel/protocol\";\n\nimport { appUrl, token } from \"./auth\";\nimport { backup } from \"./backup\";\nimport * as catalog from \"./catalog\";\nimport { Connection, request } from \"./client\";\nimport { config } from \"./config\";\nimport * as directory from \"./directory\";\nimport * as web from \"./web\";\nimport { serve } from \"./gateway\";\nimport { forget, store } from \"./keys\";\nimport { dir as logDir, failure, log, open as openLog } from \"./log\";\nimport { type Filter, follow, print } from \"./logs\";\nimport { health } from \"./health\";\nimport { preference } from \"./preferences\";\nimport { setModel } from \"./settings\";\nimport { archive, host, isRunning, kill, models, parseModel, project, remove } from \"./manage\";\n\nconst HELP = `ace — channels on this host\n\n ace new [--project ] [--name ] [--model ] [--hosted ]\n ace ls [--all]\n ace info \n ace rename rename without changing its lanes\n ace backup snapshot local channel data into a new directory\n ace say [--chat ] post without invoking the agent\n ace ask [--chat ] [--model ] [--detach] \n ace watch [--chat ]\n ace chat [--model ] open another chat\n ace stop [--chat ] stop the chat's current run\n ace kill stop all work in the channel now\n ace share on|off let others invoke agents\n ace models\n ace model [provider/id|auto] show or set the model for a chat's first agent run\n ace key set store a key in the OS keychain, read from stdin\n ace key rm \n ace directory [ | off] the team's directory, which lists every host's channels\n ace web [ | off] the deployed web app your devices may use with this host\n ace serve [--port 4140] serve the app and its WebSocket gateway\n ace logs [--channel ] [--trace ] [--level warn] [--since 10m] [--grep ]\n [-n 200] [--follow] [--json] every process's logs, merged in time order\n ace open [--port 4140] open this host's authenticated app\n ace archive | unarchive | delete \n\nModels are provider/id, such as openai/gpt-6-astra or anthropic/claude-opus-5-5.\nA credential such as OPENAI_API_KEY comes from ACE_OPENAI_API_KEY, then OPENAI_API_KEY, then the\nkeychain. Store keys there for the desktop app, which starts without your shell's environment.`;\n\nconst { values: flags, positionals } = parseArgs({\n\tallowPositionals: true,\n\toptions: {\n\t\tproject: { type: \"string\" },\n\t\tname: { type: \"string\" },\n\t\tmodel: { type: \"string\" },\n\t\thosted: { type: \"string\" },\n\t\tchat: { type: \"string\" },\n\t\tport: { type: \"string\" },\n\t\tall: { type: \"boolean\" },\n\t\tdetach: { type: \"boolean\" },\n\t\tchannel: { type: \"string\" },\n\t\ttrace: { type: \"string\" },\n\t\tlevel: { type: \"string\" },\n\t\tsince: { type: \"string\" },\n\t\tgrep: { type: \"string\" },\n\t\tlines: { type: \"string\", short: \"n\" },\n\t\tfollow: { type: \"boolean\", short: \"f\" },\n\t\tjson: { type: \"boolean\" },\n\t\thelp: { type: \"boolean\", short: \"h\" },\n\t},\n});\nconst [command, ref, ...rest] = positionals;\n\nconst model = parseModel;\n\nfunction chat(): ChatId | undefined {\n\treturn flags.chat === undefined ? undefined : Number(flags.chat);\n}\n\nconst dim = (text: string) => `\\x1b[2m${text}\\x1b[0m`;\nconst bold = (text: string) => `\\x1b[1m${text}\\x1b[0m`;\n\nfunction clip(text: string, length: number): string {\n\tconst line = text.replace(/\\s+/g, \" \").trim();\n\treturn line.length > length ? `${line.slice(0, length - 1)}…` : line;\n}\n\nfunction render(event: Event, info: ChannelInfo) {\n\tconst tag = event.chat === 1 && info.chats.length === 1 ? \"\" : dim(`[${event.chat}] `);\n\tswitch (event.kind) {\n\t\tcase \"message\":\n\t\t\treturn console.log(`${tag}${bold(event.author)}: ${event.text}`);\n\t\tcase \"reply\": {\n\t\t\tconst ending = event.error\n\t\t\t\t? `\\x1b[31m${event.text ? \"\\n\" : \"\"}Run failed: ${event.error}\\x1b[0m`\n\t\t\t\t: event.stopped\n\t\t\t\t? dim(`${event.text ? \"\\n\" : \"\"}Stopped.`)\n\t\t\t\t: \"\";\n\t\t\treturn console.log(`${tag}${bold(event.model)}: ${event.text}${ending}`);\n\t\t}\n\t\tcase \"tool\":\n\t\t\treturn console.log(dim(`${tag} → ${event.name} ${clip(JSON.stringify(event.args), 100)}`));\n\t\tcase \"result\":\n\t\t\treturn console.log(dim(`${tag} ${event.error ? \"✗\" : \"←\"} ${clip(event.text, 100)}`));\n\t\tcase \"run\":\n\t\t\treturn event.state === \"end\" && console.log(dim(`${tag} (run ended)`));\n\t}\n}\n\nasync function watch(id: string, until?: (event: Event) => boolean, replay = true) {\n\tconst connection = await Connection.open(id);\n\tconst info = await connection.request({ op: \"info\" });\n\tlet live = false;\n\tconst done = Promise.withResolvers();\n\tawait connection.request({ op: \"watch\", chat: chat() }, (event) => {\n\t\tif (event.kind === \"live\") return void (live = true);\n\t\tif (live || replay) render(event, info);\n\t\tif (live && until?.(event)) done.resolve();\n\t});\n\treturn { connection, done: done.promise };\n}\n\n/** `10m`, `2h`, `1d`, or an ISO time. */\nfunction since(value: string): number {\n\tconst match = /^(\\d+)([smhd])$/.exec(value);\n\tif (!match) return Date.parse(value);\n\tconst unit = { s: 1e3, m: 6e4, h: 36e5, d: 864e5 }[match[2] as \"s\" | \"m\" | \"h\" | \"d\"];\n\treturn Date.now() - Number(match[1]) * unit;\n}\n\nasync function main() {\n\tif (flags.help || !command) return console.log(HELP);\n\tif (command !== \"serve\" && command !== \"logs\") {\n\t\topenLog(\"cli\");\n\t\tlog(\"info\", \"cli.command\", { command, ...(ref ? { ref } : {}) });\n\t}\n\tswitch (command) {\n\t\tcase \"logs\": {\n\t\t\tconst filter: Filter = {};\n\t\t\t// Ids of channels this host doesn't know, such as a peer's, filter as given.\n\t\t\tif (flags.channel) {\n\t\t\t\tfilter.channel = catalog.list().find((r) => r.name === flags.channel)?.id ?? flags.channel;\n\t\t\t}\n\t\t\tif (flags.trace) filter.trace = flags.trace;\n\t\t\tif (flags.level) filter.level = flags.level;\n\t\t\tif (flags.since) filter.since = since(flags.since);\n\t\t\tif (flags.grep) filter.grep = flags.grep;\n\t\t\tif (flags.follow) return follow(filter, !!flags.json);\n\t\t\tprint(filter, Number(flags.lines || 200), !!flags.json);\n\t\t\tif (!flags.json) console.error(`\\x1b[2m${logDir}\\x1b[0m`);\n\t\t\treturn;\n\t\t}\n\t\tcase \"new\": {\n\t\t\tconst dir = project(resolve(flags.project || \".\"));\n\t\t\tconst model = flags.model ? parseModel(flags.model) : undefined;\n\t\t\tconst record = flags.hosted\n\t\t\t\t? await host(dir, model, flags.name, flags.hosted)\n\t\t\t\t: catalog.create(dir, model, flags.name);\n\t\t\treturn console.log(`${record.name}\\t${record.id}`);\n\t\t}\n\t\tcase \"ls\": {\n\t\t\tfor (const record of catalog.list()) {\n\t\t\t\tif (record.archived && !flags.all) continue;\n\t\t\t\tconst running = isRunning(record.id) ? \"running\" : \"dormant\";\n\t\t\t\tconst state = record.archived ? \"archived\" : running;\n\t\t\t\tconsole.log(\n\t\t\t\t\t[\n\t\t\t\t\t\trecord.name,\n\t\t\t\t\t\trecord.id,\n\t\t\t\t\t\tstate,\n\t\t\t\t\t\trecord.model ? `${record.model.provider}/${record.model.modelId}` : \"automatic\",\n\t\t\t\t\t\trecord.project,\n\t\t\t\t\t].join(\"\\t\"),\n\t\t\t\t);\n\t\t\t}\n\t\t\treturn;\n\t\t}\n\t\tcase \"models\": {\n\t\t\tfor (const m of await models()) console.log(`${m.provider}/${m.modelId}`);\n\t\t\treturn;\n\t\t}\n\t\tcase \"directory\": {\n\t\t\tif (ref) directory.configure(ref === \"off\" ? undefined : ref);\n\t\t\treturn console.log(directory.url() ?? \"No directory\");\n\t\t}\n\t\tcase \"web\": {\n\t\t\tif (ref) web.configure(ref === \"off\" ? undefined : ref);\n\t\t\treturn console.log(web.app() ?? \"No web app\");\n\t\t}\n\t\tcase \"model\": {\n\t\t\tif (ref) await setModel(ref === \"auto\" ? null : parseModel(ref));\n\t\t\tconst saved = preference();\n\t\t\tconsole.log(saved ? `${saved.provider}/${saved.modelId}` : \"Automatic\");\n\t\t\tif (config.model) console.log(`Overridden by ACE_MODEL=${config.model}`);\n\t\t\treturn;\n\t\t}\n\t\tcase \"open\": {\n\t\t\tconst port = Number(flags.port || config.port);\n\t\t\tconst info = await health(port);\n\t\t\tif (!info || info.home !== config.home) {\n\t\t\t\tthrow new Error(\"Start this host with ace serve first\");\n\t\t\t}\n\t\t\tconst url = appUrl(port);\n\t\t\turl.hash = new URLSearchParams({ token: token() }).toString();\n\t\t\tconst result = Bun.spawnSync([process.platform === \"darwin\" ? \"open\" : \"xdg-open\", url.href]);\n\t\t\tif (!result.success) throw new Error(\"Could not open Ace in your browser\");\n\t\t\treturn;\n\t\t}\n\t\tcase \"serve\":\n\t\t\treturn serve(Number(flags.port || config.port));\n\t\tcase \"key\": {\n\t\t\tconst name = rest[0];\n\t\t\tif (!name || !/^[A-Z][A-Z0-9_]*$/.test(name)) {\n\t\t\t\tthrow new Error(\"ace key set|rm , such as OPENAI_API_KEY\");\n\t\t\t}\n\t\t\tif (ref === \"rm\") {\n\t\t\t\treturn console.log(await forget(name) ? `Removed ${name}` : `No ${name} in the keychain`);\n\t\t\t}\n\t\t\tif (ref !== \"set\") throw new Error(\"ace key set|rm \");\n\t\t\t// From stdin so the key stays out of shell history and the process list.\n\t\t\tif (process.stdin.isTTY) process.stderr.write(`${name} (end with Ctrl-D): `);\n\t\t\tconst value = (await new Response(Bun.stdin.stream()).text()).trim();\n\t\t\tif (!value) throw new Error(\"No key on stdin\");\n\t\t\tawait store(name, value);\n\t\t\treturn console.log(`Stored ${name} in the keychain`);\n\t\t}\n\t}\n\n\tif (!ref) throw new Error(`ace ${command} needs a channel`);\n\tconst record = catalog.find(ref);\n\tconst text = rest.join(\" \");\n\tswitch (command) {\n\t\tcase \"backup\":\n\t\t\tif (rest.length !== 1) throw new Error(\"ace backup

\");\n\t\t\tconsole.log(await backup(record, rest[0]!));\n\t\t\tconsole.log(\"Channel data saved. Back up project files and lane worktrees separately.\");\n\t\t\treturn;\n\t\tcase \"info\":\n\t\t\treturn console.log(JSON.stringify(await request(record.id, { op: \"info\" }), null, 2));\n\t\tcase \"rename\":\n\t\t\tif (rest.length !== 1) throw new Error(\"ace rename \");\n\t\t\tawait request(record.id, { op: \"rename\", author: catalog.user, name: rest[0]! });\n\t\t\treturn;\n\t\tcase \"say\":\n\t\t\tif (!text) throw new Error(\"Nothing to say\");\n\t\t\tawait request(record.id, { op: \"say\", chat: chat(), author: catalog.user, text });\n\t\t\treturn;\n\t\tcase \"ask\": {\n\t\t\tif (!text) throw new Error(\"Nothing to ask\");\n\t\t\tconst selected = flags.model ? model(flags.model) : undefined;\n\t\t\tconst body = {\n\t\t\t\top: \"ask\",\n\t\t\t\tchat: chat(),\n\t\t\t\tauthor: catalog.user,\n\t\t\t\ttext,\n\t\t\t\tmodel: selected,\n\t\t\t} as const;\n\t\t\tif (flags.detach) return void (await request(record.id, body));\n\t\t\tconst { connection } = await watch(record.id, undefined, false);\n\t\t\tconst { submission } = await connection.request<{ submission: number }>(body);\n\t\t\tprocess.on(\"SIGINT\", () => {\n\t\t\t\tconsole.log(dim(`\\nDetached; the run continues. Stop it with: ace stop ${record.name}`));\n\t\t\t\tprocess.exit(130);\n\t\t\t});\n\t\t\tconst status = await connection.request({ op: \"wait\", submission });\n\t\t\tif (status === \"unanswered\") console.log(dim(\" (stopped before answering)\"));\n\t\t\treturn connection.close();\n\t\t}\n\t\tcase \"watch\": {\n\t\t\tconst { connection } = await watch(record.id);\n\t\t\treturn connection.closed;\n\t\t}\n\t\tcase \"chat\": {\n\t\t\tconst body = {\n\t\t\t\top: \"chat\",\n\t\t\t\tauthor: catalog.user,\n\t\t\t\tmodel: flags.model ? model(flags.model) : undefined,\n\t\t\t} as const;\n\t\t\tconst created = await request<{ chat: number }>(record.id, body);\n\t\t\treturn console.log(created.chat);\n\t\t}\n\t\tcase \"stop\":\n\t\t\tawait request(record.id, { op: \"stop\", chat: chat() });\n\t\t\treturn;\n\t\tcase \"kill\":\n\t\t\treturn kill(record.id);\n\t\tcase \"share\":\n\t\t\tawait request(record.id, { op: \"share\", author: catalog.user, shared: rest[0] === \"on\" });\n\t\t\treturn;\n\t\tcase \"archive\":\n\t\t\treturn void (await archive(record.id, true));\n\t\tcase \"unarchive\":\n\t\t\treturn void (await archive(record.id, false));\n\t\tcase \"delete\":\n\t\t\tawait remove(record.id);\n\t\t\treturn console.log(`Deleted ${record.name}. Its lane branches remain in ${record.project}.`);\n\t}\n\tthrow new Error(`Unknown command ${command}\\n\\n${HELP}`);\n}\n\nmain().then(\n\t() => process.exit(0),\n\t(error: Error) => {\n\t\tlog(\"error\", \"cli.failed\", { command, ...failure(error) });\n\t\tconsole.error(error.message);\n\t\tprocess.exit(1);\n\t},\n);\n","editable",false,"branch","documentNavigation","repo","githubnext/ace2","repoId","938fe4cd-5320-4e4f-ac7c-87d4dad8490c","ownerId","org:89615882","site","nexthub","private","admin","settings","maintainer","triage","starred","stars",0,"watchers","watching","pinned","notify","views",[226,227,228,229,230,231,232,233,234,235,236,237,238],"navigation",{"_54":55,"_182":183,"_184":185,"_186":187,"_188":189,"_190":191,"_192":193},"sources",[],"viewer","meta",{"_174":175,"_176":177,"_178":179,"_42":31,"_180":166,"_181":31,"_48":49,"_50":49},"branches",[81,82,83,84,85,86,87,88,89,90,91,92,93,94,95,96,97,98,99,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140,141,142,143,144,145,146,147,148,149,150,151,152,153,154,155,156,157,158,159,160,161,162,163,164,165,166,167,168,169,170,171,172,173],"tags",[69,70,71,72,73,74,75,76,77,78,79,80],"cloneUrl","https://git.nexthub.sh/githubnext/ace2.git","desktop-canary-v0.0.10","desktop-canary-v0.0.11","desktop-canary-v0.0.12","desktop-canary-v0.0.13","desktop-canary-v0.0.14","desktop-canary-v0.0.15","desktop-canary-v0.0.16","desktop-canary-v0.0.18","desktop-canary-v0.0.21","desktop-canary-v0.0.7","desktop-canary-v0.0.8","desktop-canary-v0.0.9","amber-beacon/composer-effort","brisk-ember/github-avatars","brisk-grove/image-paste-91","calm-anchor/fix-streaming-draft-overlap","calm-grove/composer-agent-mode","cloud-pilot-ops/canary-0-0-17","cloud-pilot-ops/cloud-move","cloud-pilot-ops/cloud-pilot","codex/agentation-shortcut","codex/annotation-polish","codex/browser-pages","codex/canary-0-0-21","codex/canary-0.0.11","codex/channel-delete-close","codex/channel-watch-recovery","codex/clipboard-files-write","codex/composer-coordinate-check","codex/computer-use-validation","codex/desktop-actions","codex/desktop-app-search","codex/desktop-app-state","codex/desktop-availability","codex/desktop-click-variants","codex/desktop-clipboard","codex/desktop-clipboard-files","codex/desktop-clipboard-image","codex/desktop-clipboard-image-write","codex/desktop-clipboard-text","codex/desktop-drag","codex/desktop-keyboard","codex/desktop-launch","codex/desktop-locked-feedback","codex/desktop-menu-command","codex/desktop-menu-inventory","codex/desktop-minimize","codex/desktop-open","codex/desktop-pointer","codex/desktop-quit","codex/desktop-selection-keys","codex/desktop-tool-guidance","codex/desktop-tools-extraction","codex/desktop-window-close","codex/desktop-window-geometry","codex/desktop-windows","codex/dev-permission-identity","codex/durable-composer-drafts","codex/fix-message-clipping","codex/lane-base-96","codex/native-patch-prefix","codex/peekaboo","codex/peer-channel-messaging","codex/pixel-snapshot-authority","codex/publish-canary-0-0-21","codex/readme-security","codex/settings-refresh","codex/stale-click-refusal","codex/tab-renaming-api","codex/team-agent-access","codex/team-channel-sections","codex/team-dogfood-integration","codex/webkit-coordinate-window","codex/webkit-desktop-focus","deft-beacon/helper-isolation","deft-grove/align-avatar-byline","deft-grove/build-canary-0-0-18","deft-grove/canary-github-releases","deft-grove/ship-canary-0-0-18","deft-meadow/details-sidebar","fair-ember/canary-0-0-13","fair-ember/canary-0-0-14","fair-fjord/all-projects","feat/github-cache","feat/rebuild","fix/channel-credentials","glad-anchor/restore-message-queue","glad-ember/archive-inactive-channels","glad-fjord/project-identity","glad-orbit/channel-progress","glad-ridge/terminal-replay-input","hazy-anchor/github-row-actions","hazy-ember/channel-access-toggles","hazy-grove/all-projects-add-channel","local-project-setup/build-canary-0-0-20","local-project-setup/canary-0-0-20","local-project-setup/local-project-setup","main","mellow-ridge/canary-0-0-16","mellow-ridge/top-bar-drag-area","nimble-cedar/modal-top-offset","nimble-meadow/canary-0-0-15","remote-channel-load/build-canary-0-0-19","remote-channel-load/canary-0-0-19","remote-channel-load/fix-remote-channel-load","description","Ace: a collaborative coding environment on the team's own machines","owner","githubnext","section","","head","empty","pins",[208,209,210],"documents",{"_203":204,"_205":206},"code",{"_199":200,"_201":202},"automations",{"_196":197,"_198":-5},"delivery",{"_194":49,"_195":-5},"tag","9Rn62lcgXCFfpmCuooTjLxGyUf8","releases","applications","workflows",2,"deployments","commits",215,"changes",1,"counts",{"_207":206},"total",86,"issue",{"_211":201,"_213":224,"_15":201,"_215":225,"_52":217,"_218":31,"_219":217,"_220":202},{"_211":221,"_213":222,"_15":221,"_215":223,"_52":217,"_218":31,"_219":217,"_220":49},{"_211":212,"_213":214,"_15":212,"_215":216,"_52":217,"_218":31,"_219":217,"_220":206},"id","issues","name","Issues","filters",{},true,"saved","pinnable","count","tasks","Tasks",{},"Changes",{},{"_211":201,"_213":224,"_15":201,"_215":269,"_52":217,"_218":31,"_219":217},{"_211":221,"_213":222,"_15":221,"_215":268,"_52":217,"_218":31,"_219":217},{"_211":212,"_213":214,"_15":212,"_215":267,"_52":217,"_218":31,"_219":217},{"_211":264,"_213":265,"_15":264,"_215":266,"_52":31,"_218":31,"_219":217},{"_211":261,"_213":262,"_15":261,"_215":263,"_52":31,"_218":31,"_219":217},{"_211":196,"_213":259,"_15":188,"_215":260,"_52":31,"_218":31,"_219":217},{"_211":198,"_213":256,"_15":257,"_215":258,"_52":31,"_218":31,"_219":217},{"_211":194,"_213":254,"_15":194,"_215":255,"_52":31,"_218":31,"_219":217},{"_211":250,"_213":251,"_15":252,"_215":253,"_52":31,"_218":31,"_219":217},{"_211":184,"_213":248,"_15":184,"_215":249,"_52":31,"_218":31,"_219":31},{"_211":245,"_213":246,"_15":245,"_215":247,"_52":31,"_218":31,"_219":31},{"_211":242,"_213":243,"_15":242,"_215":244,"_52":31,"_218":31,"_219":31},{"_211":239,"_213":240,"_15":239,"_215":241,"_52":31,"_218":31,"_219":31},"decisions","Decisions",{},"changelog","Changelog",{},"roadmap","Roadmap",{},"Documents",{},"activity","Activity","insights",{},"Releases",{},"Deployments","automations/deployments",{},"Workflows",{},"discussions","Discussions",{},"goals","Goals",{},{},{},{},"groups","user","agents",[],"now",1794436297036,"sidebar","expanded"]