feat: one-shot CLI mode with subcommands (agent, websearch, web-fetch, list)

[Copilot]

agentloop had no non-interactive invocation mode — every entry point dropped into a readline REPL, making it unusable in scripts, Makefiles, or CI pipelines.

New: src/start-oneshot.ts

Scriptable entry point that parses a subcommand, runs one operation, prints to stdout, and exits.

# Run the agent loop once
npm run oneshot -- agent -u "What files are in src/?"
npm run oneshot -- agent -s "You are terse." -u "Summarise README" --json
npm run oneshot -- agent --profile coder --stream -u "Refactor src/config.ts"

# Invoke tools directly (no LLM involved)
npm run oneshot -- websearch -q "LangChain tool calling" -n 3 --json
npm run oneshot -- web-fetch -u "https://example.com"

# Discover capabilities
npm run oneshot -- list tools
npm run oneshot -- list agentprofiles

Subcommand	Key flags
agent	-u (required), -s system override, -p profile, --stream, --json
websearch	-q (required), -n max results, --json
web-fetch	-u (required), --json
list	tools | agentprofiles

Uses Node.js built-in util.parseArgs — no new dependencies. Unknown subcommands print help and exit 1.

Changes to src/index.ts

• Exported ensureInitialized() — allows external entry points to load the tool registry before direct tool invocation (no LLM call needed for websearch/web-fetch/list).
• Exported agentProfileRegistry.
• Added AgentRunOptions interface with systemPromptOverride?: string; threaded through executeWithTools and executeWithToolsStream as an optional third parameter (fully backward-compatible). When set, replaces the auto-generated system prompt for that invocation.

Other

• package.json: added "oneshot": "npx tsx src/start-oneshot.ts" script.
• README.md: added "One-Shot CLI Mode" section with examples and flag tables.
• 22 new unit tests covering argument parsing for all subcommands and AgentRunOptions propagation.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• duckduckgo.com
  • Triggering command: /opt/hostedtoolcache/node/24.14.0/x64/bin/node /opt/hostedtoolcache/node/24.14.0/x64/bin/node /home/REDACTED/work/agentloop/agentloop/node_modules/jest-worker/build/processChild.js (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

---

⚡ Quickly spin up Copilot coding agent tasks from anywhere on your macOS or Windows machine with Raycast.