@interactive-inc/claude-funnel 0.2.0 → 0.3.0

package/README.md

@@ -56,7 +56,9 @@ fnl connectors <name>                       show details
 fnl connectors <name> set [--bot-token ...] [--app-token ...]
 fnl connectors rename <old> <new>
 fnl connectors remove <name>
-fnl connectors <name> <method> <path> [body]   call API (get/post/put/delete/...)
+
+fnl request slack   post <path> [body] --connector <name>   call Slack Web API
+fnl request discord <method> <path> [body] --connector <name>   call Discord REST API
 
 fnl channels                                list
 fnl channels add <name>
@@ -66,27 +68,31 @@ fnl channels <name> connectors detach <connector>
 fnl channels rename <old> <new>
 fnl channels remove <name>
 
-fnl agents                                  list agent presets (extra)
-fnl agents add <name> --channel <c> [--repo <r>] [--sub-agent <s>] [--env-file <f>]
-fnl agents <name>                           launch (sugar for fnl claude)
-fnl agents <name> set [--channel ...] [--repo ...] [--sub-agent ...] [--env-file ...]
-fnl agents rename <old> <new>
-fnl agents remove <name>
+fnl profiles                                list launch profiles
+fnl profiles add <name> --channel <c> [--repo <r>] [--sub-agent <s>] [--env-file <f>]
+fnl profiles <name> run                     launch (sugar for fnl claude)
+fnl profiles <name>                         launch (alias for run)
+fnl profiles <name> set [--channel ...] [--repo ...] [--sub-agent ...] [--env-file ...]
+fnl profiles rename <old> <new>
+fnl profiles remove <name>
 
 fnl repos                                   list repositories (extra)
-fnl repos add <name> --path <path>          register funnel MCP into .mcp.json
+fnl repos add <name> [--path <path>]        register funnel MCP (path defaults to cwd)
 fnl repos <name>                            show details
 fnl repos <name> set [--path <path>]
 fnl repos rename <old> <new>
 fnl repos remove <name>
 
+fnl claude                                  launch the "default" profile
+fnl claude --profile <name>                 launch a named profile
 fnl claude --channel <c> [--repo <r>] [--sub-agent <s>] [--env-file <f>]
-                                            launch Claude Code
+                                            raw launch (no profile)
 fnl mcp                                     run as an MCP server (invoked from .mcp.json)
 
 fnl gateway                                 running status
 fnl gateway start / stop / restart / run / logs
-fnl status                                  overall status (connectors / channels / agents / repos / gateway)
+fnl update                                  update funnel via bun i -g
+fnl status                                  overall status (connectors / channels / profiles / repos / gateway)
 
 fnl --version
 fnl --help        (every subcommand has --help)
@@ -102,9 +108,9 @@ Connector =
 
 Channel    = { name, connectors[] }                        subscription box
 Repository = { name, path }                                 extra
-Agent      = { name, channel, repo?, subAgent?, envFiles? } preset (extra)
+Profile    = { name, channel, repo?, subAgent?, envFiles? } launch profile
 
-Settings = { connectors[], channels[], repositories[], agents[] }
+Settings = { connectors[], channels[], repositories[], profiles[] }
          → ~/.funnel/settings.json
 ```
 

package/lib/funnel.ts

@@ -1,9 +1,9 @@
-import { FunnelAgents } from "@/modules/agents/funnel-agents"
 import { FunnelChannels } from "@/modules/channels/funnel-channels"
 import { FunnelClaude } from "@/modules/claude/funnel-claude"
 import { FunnelConnectors } from "@/modules/connectors/funnel-connectors"
 import { FunnelGateway } from "@/modules/gateway/funnel-gateway"
 import { FunnelMcp } from "@/modules/mcp/funnel-mcp"
+import { FunnelProfiles } from "@/modules/profiles/funnel-profiles"
 import { FunnelRepositories } from "@/modules/repos/funnel-repositories"
 import { FunnelSettingsReader } from "@/modules/settings/funnel-settings-reader"
 
@@ -24,8 +24,8 @@ export class Funnel {
     return new FunnelChannels({ store: this.props.store })
   }
 
-  get agents(): FunnelAgents {
-    return new FunnelAgents({ store: this.props.store })
+  get profiles(): FunnelProfiles {
+    return new FunnelProfiles({ store: this.props.store })
   }
 
   get repositories(): FunnelRepositories {

package/lib/index.ts

@@ -13,13 +13,15 @@ usage: funnel [command]
 
 commands:
   (none)                launch TUI
-  claude --channel <c>  launch Claude Code
+  claude                launch Claude Code (default profile or --profile)
   connectors            manage external connections (Slack, etc.)
   channels              manage subscription boxes
-  agents                manage agent presets (extra)
+  profiles              manage launch profiles
+  request               send an outbound API call via a connector
   repos                 manage repositories (extra)
   gateway               manage the gateway
   status                show overall connection status
+  update                update funnel to the latest version
   mcp                   run as an MCP server (invoked from .mcp.json)
 
 options:

package/lib/modules/channels/funnel-channels.ts

@@ -46,8 +46,8 @@ export class FunnelChannels {
 
     if (index < 0) throw new Error(`channel "${name}" not found`)
 
-    if (settings.agents.some((a) => a.channel === name)) {
-      throw new Error(`channel "${name}" is referenced by an agent`)
+    if (settings.profiles.some((p) => p.channel === name)) {
+      throw new Error(`channel "${name}" is referenced by a profile`)
     }
 
     settings.channels.splice(index, 1)
@@ -68,8 +68,8 @@ export class FunnelChannels {
 
     channel.name = newName
 
-    for (const agent of settings.agents) {
-      if (agent.channel === oldName) agent.channel = newName
+    for (const profile of settings.profiles) {
+      if (profile.channel === oldName) profile.channel = newName
     }
 
     this.store.write(settings)

package/lib/modules/claude/funnel-claude.ts

@@ -1,3 +1,4 @@
+import { join } from "node:path"
 import type { FunnelChannels } from "@/modules/channels/funnel-channels"
 import { FunnelFileSystem } from "@/modules/fs/funnel-file-system"
 import { NodeFunnelFileSystem } from "@/modules/fs/node-funnel-file-system"
@@ -7,6 +8,9 @@ import type { FunnelMcp } from "@/modules/mcp/funnel-mcp"
 import { FunnelProcessRunner } from "@/modules/process/funnel-process-runner"
 import { NodeFunnelProcessRunner } from "@/modules/process/node-funnel-process-runner"
 import type { FunnelRepositories } from "@/modules/repos/funnel-repositories"
+import { FUNNEL_DIR } from "@/modules/settings/funnel-settings-store"
+
+const CLAUDE_PID_DIR = join(FUNNEL_DIR, "claude")
 
 export type LaunchOptions = {
   channel: string
@@ -14,6 +18,7 @@ export type LaunchOptions = {
   subAgent?: string
   envFiles?: string[]
   userArgs?: string[]
+  profileName?: string
 }
 
 type Deps = {
@@ -53,6 +58,10 @@ export class FunnelClaude {
       throw new Error(`channel "${options.channel}" not found`)
     }
 
+    if (options.profileName && this.isRunning(options.profileName)) {
+      throw new Error(`profile "${options.profileName}" is already running`)
+    }
+
     const cwd = options.repo
       ? this.repositories.resolvePath(options.repo)
       : globalThis.process.cwd()
@@ -68,6 +77,11 @@ export class FunnelClaude {
       await this.gateway.start()
     }
 
+    if (options.profileName) {
+      this.writePidFile(options.profileName)
+      this.installCleanup(options.profileName)
+    }
+
     const claudeArgs = this.buildArgs(options, cwd)
     const env = this.buildEnv(options, cwd)
 
@@ -78,7 +92,71 @@ export class FunnelClaude {
       cwd,
     })
 
-    return await this.process.attach(["claude", ...claudeArgs], { cwd, env })
+    try {
+      return await this.process.attach(["claude", ...claudeArgs], { cwd, env })
+    } finally {
+      if (options.profileName) this.removePidFile(options.profileName)
+    }
+  }
+
+  isRunning(profileName: string): boolean {
+    const pid = this.readPid(profileName)
+
+    if (!pid) return false
+
+    return this.isProcessAlive(pid)
+  }
+
+  private pidPath(profileName: string): string {
+    return join(CLAUDE_PID_DIR, `${profileName}.pid`)
+  }
+
+  private readPid(profileName: string): number | null {
+    const path = this.pidPath(profileName)
+
+    if (!this.fs.existsSync(path)) return null
+
+    try {
+      const content = this.fs.readFileSync(path).trim()
+      const pid = Number(content)
+
+      if (!pid || pid <= 0) return null
+
+      return pid
+    } catch {
+      return null
+    }
+  }
+
+  private writePidFile(profileName: string): void {
+    this.fs.mkdirSync(CLAUDE_PID_DIR, { recursive: true })
+    this.fs.writeFileSync(this.pidPath(profileName), String(globalThis.process.pid))
+  }
+
+  private removePidFile(profileName: string): void {
+    const path = this.pidPath(profileName)
+
+    if (this.fs.existsSync(path)) this.fs.unlink(path)
+  }
+
+  private installCleanup(profileName: string): void {
+    const cleanup = () => this.removePidFile(profileName)
+
+    globalThis.process.once("exit", cleanup)
+    globalThis.process.once("SIGINT", cleanup)
+    globalThis.process.once("SIGTERM", cleanup)
+  }
+
+  private isProcessAlive(pid: number): boolean {
+    const result = this.process.runSync(["ps", "-p", String(pid), "-o", "state="])
+
+    if (result.exitCode !== 0) return false
+
+    const state = result.stdout.trim()
+
+    if (!state) return false
+
+    return !state.startsWith("Z")
   }
 
   private buildArgs(options: LaunchOptions, cwd: string): string[] {

package/lib/modules/mcp/channel-server.ts

@@ -16,8 +16,7 @@ export const startChannelServer = async (): Promise<void> => {
       instructions: [
         `Events arrive inside <channel source="${FUNNEL_MCP_NAME}"> tags. Use meta.event_type to discriminate.`,
         "",
-        'event_type="slack": a Slack message. meta includes channel_id, user_id, mentioned, thread_ts, etc. content is the Slack event JSON.',
-        'event_type="system": system event (connect / disconnect / startup, etc.).',
+        "To reply or act on an event, run `funnel request <platform> --help` via the Bash tool (e.g. `funnel request slack --help`). For general CLI usage, run `funnel --help`.",
       ].join("\n"),
     },
   )

package/lib/modules/{agents/funnel-agents.ts → profiles/funnel-profiles.ts}

@@ -1,11 +1,11 @@
 import { FunnelSettingsReader } from "@/modules/settings/funnel-settings-reader"
-import type { AgentConfig } from "@/modules/settings/settings-schema"
+import type { ProfileConfig } from "@/modules/settings/settings-schema"
 
 type Deps = {
   store: FunnelSettingsReader
 }
 
-export class FunnelAgents {
+export class FunnelProfiles {
   private readonly store: FunnelSettingsReader
 
   constructor(deps: Deps) {
@@ -13,19 +13,19 @@ export class FunnelAgents {
     Object.freeze(this)
   }
 
-  list(): AgentConfig[] {
-    return this.store.read().agents
+  list(): ProfileConfig[] {
+    return this.store.read().profiles
   }
 
-  get(name: string): AgentConfig | null {
-    return this.list().find((a) => a.name === name) ?? null
+  get(name: string): ProfileConfig | null {
+    return this.list().find((p) => p.name === name) ?? null
   }
 
-  add(config: AgentConfig): void {
+  add(config: ProfileConfig): void {
     const settings = this.store.read()
 
-    if (settings.agents.some((a) => a.name === config.name)) {
-      throw new Error(`agent "${config.name}" already exists`)
+    if (settings.profiles.some((p) => p.name === config.name)) {
+      throw new Error(`profile "${config.name}" already exists`)
     }
 
     if (!settings.channels.some((c) => c.name === config.channel)) {
@@ -36,7 +36,7 @@ export class FunnelAgents {
       throw new Error(`repo "${config.repo}" not found`)
     }
 
-    settings.agents.push(config)
+    settings.profiles.push(config)
 
     this.store.write(settings)
   }
@@ -44,11 +44,11 @@ export class FunnelAgents {
   remove(name: string): void {
     const settings = this.store.read()
 
-    const index = settings.agents.findIndex((a) => a.name === name)
+    const index = settings.profiles.findIndex((p) => p.name === name)
 
-    if (index < 0) throw new Error(`agent "${name}" not found`)
+    if (index < 0) throw new Error(`profile "${name}" not found`)
 
-    settings.agents.splice(index, 1)
+    settings.profiles.splice(index, 1)
 
     this.store.write(settings)
   }
@@ -56,32 +56,32 @@ export class FunnelAgents {
   rename(oldName: string, newName: string): void {
     const settings = this.store.read()
 
-    const agent = settings.agents.find((a) => a.name === oldName)
+    const profile = settings.profiles.find((p) => p.name === oldName)
 
-    if (!agent) throw new Error(`agent "${oldName}" not found`)
+    if (!profile) throw new Error(`profile "${oldName}" not found`)
 
-    if (settings.agents.some((a) => a.name === newName)) {
-      throw new Error(`agent "${newName}" already exists`)
+    if (settings.profiles.some((p) => p.name === newName)) {
+      throw new Error(`profile "${newName}" already exists`)
     }
 
-    agent.name = newName
+    profile.name = newName
 
     this.store.write(settings)
   }
 
-  update(name: string, fields: Partial<Omit<AgentConfig, "name">>): void {
+  update(name: string, fields: Partial<Omit<ProfileConfig, "name">>): void {
     const settings = this.store.read()
 
-    const agent = settings.agents.find((a) => a.name === name)
+    const profile = settings.profiles.find((p) => p.name === name)
 
-    if (!agent) throw new Error(`agent "${name}" not found`)
+    if (!profile) throw new Error(`profile "${name}" not found`)
 
     if (fields.channel !== undefined) {
       if (!settings.channels.some((c) => c.name === fields.channel)) {
         throw new Error(`channel "${fields.channel}" not found`)
       }
 
-      agent.channel = fields.channel
+      profile.channel = fields.channel
     }
 
     if (fields.repo !== undefined) {
@@ -89,15 +89,15 @@ export class FunnelAgents {
         throw new Error(`repo "${fields.repo}" not found`)
       }
 
-      agent.repo = fields.repo || undefined
+      profile.repo = fields.repo || undefined
     }
 
     if (fields.subAgent !== undefined) {
-      agent.subAgent = fields.subAgent || undefined
+      profile.subAgent = fields.subAgent || undefined
     }
 
     if (fields.envFiles !== undefined) {
-      agent.envFiles = fields.envFiles
+      profile.envFiles = fields.envFiles
     }
 
     this.store.write(settings)

package/lib/modules/repos/funnel-repositories.ts

@@ -46,8 +46,8 @@ export class FunnelRepositories {
 
     if (index < 0) throw new Error(`repo "${name}" not found`)
 
-    if (settings.agents.some((a) => a.repo === name)) {
-      throw new Error(`repo "${name}" is referenced by an agent`)
+    if (settings.profiles.some((p) => p.repo === name)) {
+      throw new Error(`repo "${name}" is referenced by a profile`)
     }
 
     const repo = settings.repositories[index]!
@@ -72,8 +72,8 @@ export class FunnelRepositories {
 
     repo.name = newName
 
-    for (const agent of settings.agents) {
-      if (agent.repo === oldName) agent.repo = newName
+    for (const profile of settings.profiles) {
+      if (profile.repo === oldName) profile.repo = newName
     }
 
     this.store.write(settings)

package/lib/modules/router/to-request.ts

@@ -7,7 +7,6 @@ const STRIPPED_METHOD_KEYWORDS: Record<string, string> = {
   add: "POST",
   remove: "DELETE",
   set: "PUT",
-  update: "PUT",
 }
 
 const KEPT_METHOD_KEYWORDS: Record<string, string> = {
@@ -24,8 +23,6 @@ const isValue = (arg: string | undefined): arg is string => {
 }
 
 const consumeApiCall = (args: string[], i: number, params: URLSearchParams): number => {
-  params.set("method", args[i]!)
-
   const nextPath = args[i + 1]
 
   if (!isValue(nextPath)) return 1
@@ -99,8 +96,8 @@ export const toRequest = (args: string[]) => {
       continue
     }
 
-    if (API_CALL_METHODS.has(arg) && !params.has("method")) {
-      segments.push("call")
+    if (API_CALL_METHODS.has(arg) && !params.has("path")) {
+      segments.push(arg)
       i += consumeApiCall(args, i, params)
       continue
     }

package/lib/modules/settings/funnel-settings-store.ts

@@ -33,7 +33,7 @@ export class FunnelSettingsStore extends FunnelSettingsReader {
         connectors: [],
         channels: [],
         repositories: [],
-        agents: [],
+        profiles: [],
       }
     }
 

package/lib/modules/settings/mock-funnel-settings-reader.ts

@@ -5,7 +5,7 @@ export const createSettings = (partial: Partial<Settings> = {}): Settings => ({
   connectors: [],
   channels: [],
   repositories: [],
-  agents: [],
+  profiles: [],
   ...partial,
 })
 

package/lib/modules/settings/settings-schema.ts

@@ -47,7 +47,7 @@ export const repositoryConfigSchema = z.object({
 
 export type RepositoryConfig = z.infer<typeof repositoryConfigSchema>
 
-export const agentConfigSchema = z.object({
+export const profileConfigSchema = z.object({
   name: z.string(),
   channel: z.string(),
   repo: z.string().optional(),
@@ -55,13 +55,13 @@ export const agentConfigSchema = z.object({
   envFiles: z.array(z.string()).optional(),
 })
 
-export type AgentConfig = z.infer<typeof agentConfigSchema>
+export type ProfileConfig = z.infer<typeof profileConfigSchema>
 
 export const settingsSchema = z.object({
   connectors: z.array(connectorConfigSchema).default([]),
   channels: z.array(channelConfigSchema).default([]),
   repositories: z.array(repositoryConfigSchema).default([]),
-  agents: z.array(agentConfigSchema).default([]),
+  profiles: z.array(profileConfigSchema).default([]),
 })
 
 export type Settings = z.infer<typeof settingsSchema>

package/lib/routes/claude/claude.help.ts

@@ -1,11 +1,16 @@
 export const help = `funnel claude — launch Claude Code
 
-usage: funnel claude --channel <name> [--repo <name>] [--sub-agent <name>] [--env-file <file>] [additional claude args...]
+usage:
+  funnel claude                          launch "default" profile (or the first profile)
+  funnel claude --profile <name>         launch a named profile
+  funnel claude --channel <name> [opts]  raw launch (no profile)
 
-options:
-  --channel        channel name to subscribe to (required)
-  --repo           switch working directory to the named repo (extra)
+options (override profile / raw):
+  --profile        profile name to launch
+  --channel        channel name to subscribe to
+  --repo           switch working directory to the named repo
   --sub-agent      sub-agent name (passed to claude --agent)
   --env-file       additional env file to load (relative path)
 
+Any other arguments are forwarded to the claude CLI.
 On launch the FUNNEL_CHANNEL_ID env var is set and MCP connects to the gateway.`

package/lib/routes/claude/claude.ts

@@ -1,16 +1,20 @@
+import { HTTPException } from "hono/http-exception"
 import { z } from "zod"
 import { factory } from "@/factory"
 import { queryToCliArgs } from "@/modules/router/query-to-cli-args"
 import { zValidator } from "@/modules/router/validator"
 import { help } from "@/routes/claude/claude.help"
 
-const RESERVED_KEYS = ["channel", "repo", "sub-agent", "env-file"]
+const RESERVED_KEYS = ["profile", "channel", "repo", "sub-agent", "env-file"]
+
+const DEFAULT_PROFILE_NAME = "default"
 
 export const claudeHandler = factory.createHandlers(
   zValidator(
     "query",
     z
       .object({
+        profile: z.string().optional(),
         channel: z.string().optional(),
         repo: z.string().optional(),
         "sub-agent": z.string().optional(),
@@ -21,17 +25,50 @@ export const claudeHandler = factory.createHandlers(
   ),
   async (c) => {
     const query = c.req.valid("query")
+    const funnel = c.var.funnel
 
-    if (!query.channel) return c.text(help)
+    if (query.profile) {
+      const profile = funnel.profiles.get(query.profile)
 
-    const funnel = c.var.funnel
+      if (!profile) {
+        throw new HTTPException(404, { message: `profile "${query.profile}" not found` })
+      }
+
+      const exitCode = await funnel.claude.launch({
+        channel: query.channel ?? profile.channel,
+        repo: query.repo ?? profile.repo,
+        subAgent: query["sub-agent"] ?? profile.subAgent,
+        envFiles: query["env-file"] ? [query["env-file"]] : profile.envFiles,
+        userArgs: queryToCliArgs(c.req.url, RESERVED_KEYS),
+        profileName: profile.name,
+      })
+
+      process.exit(exitCode)
+    }
+
+    if (query.channel) {
+      const exitCode = await funnel.claude.launch({
+        channel: query.channel,
+        repo: query.repo,
+        subAgent: query["sub-agent"],
+        envFiles: query["env-file"] ? [query["env-file"]] : undefined,
+        userArgs: queryToCliArgs(c.req.url, RESERVED_KEYS),
+      })
+
+      process.exit(exitCode)
+    }
+
+    const defaultProfile = funnel.profiles.get(DEFAULT_PROFILE_NAME) ?? funnel.profiles.list()[0]
+
+    if (!defaultProfile) return c.text(help)
 
     const exitCode = await funnel.claude.launch({
-      channel: query.channel,
-      repo: query.repo,
-      subAgent: query["sub-agent"],
-      envFiles: query["env-file"] ? [query["env-file"]] : undefined,
+      channel: defaultProfile.channel,
+      repo: query.repo ?? defaultProfile.repo,
+      subAgent: query["sub-agent"] ?? defaultProfile.subAgent,
+      envFiles: query["env-file"] ? [query["env-file"]] : defaultProfile.envFiles,
       userArgs: queryToCliArgs(c.req.url, RESERVED_KEYS),
+      profileName: defaultProfile.name,
     })
 
     process.exit(exitCode)

package/lib/routes/connectors/routes.ts

@@ -1,6 +1,5 @@
 import { factory } from "@/factory"
 import { connectorsAddHandler } from "@/routes/connectors/add"
-import { connectorsCallHandler } from "@/routes/connectors/call"
 import { connectorsGroupHandler } from "@/routes/connectors/group"
 import { connectorsRemoveHandler } from "@/routes/connectors/remove"
 import { connectorsRenameHandler } from "@/routes/connectors/rename"
@@ -10,7 +9,6 @@ import { connectorsShowHandler } from "@/routes/connectors/show"
 export const connectorsRoutes = factory
   .createApp()
   .get("/", ...connectorsGroupHandler)
-  .get("/:name/call", ...connectorsCallHandler)
   .put("/:name/rename/:newName", ...connectorsRenameHandler)
   .put("/rename/:name/:newName", ...connectorsRenameHandler)
   .post("/:name", ...connectorsAddHandler)

package/lib/routes/profiles/add.help.ts

@@ -0,0 +1,3 @@
+export const help = `funnel profiles add — add a profile
+
+usage: funnel profiles add <name> --channel <ch> [--repo <r>] [--sub-agent <s>] [--env-file <f>]`

package/lib/routes/{agents → profiles}/add.ts

@@ -1,9 +1,9 @@
 import { z } from "zod"
 import { factory } from "@/factory"
 import { zValidator } from "@/modules/router/validator"
-import { help } from "@/routes/agents/add.help"
+import { help } from "@/routes/profiles/add.help"
 
-export const agentsAddHandler = factory.createHandlers(
+export const profilesAddHandler = factory.createHandlers(
   zValidator("param", z.object({ name: z.string() })),
   zValidator(
     "query",
@@ -20,7 +20,7 @@ export const agentsAddHandler = factory.createHandlers(
     const query = c.req.valid("query")
     const funnel = c.var.funnel
 
-    funnel.agents.add({
+    funnel.profiles.add({
       name: param.name,
       channel: query.channel,
       repo: query.repo,
@@ -28,6 +28,6 @@ export const agentsAddHandler = factory.createHandlers(
       envFiles: query["env-file"] ? [query["env-file"]] : undefined,
     })
 
-    return c.text(`added agent "${param.name}"`)
+    return c.text(`added profile "${param.name}"`)
   },
 )

package/lib/routes/profiles/group.help.ts

@@ -0,0 +1,16 @@
+export const help = `funnel profiles — manage launch profiles
+
+usage: funnel profiles [subcommand]
+
+subcommands:
+  (none)                          list
+  add <name> --channel <ch> [--repo <r>] [--sub-agent <s>] [--env-file <f>]
+  <name> set [--channel ...] [--repo ...] [--sub-agent ...] [--env-file ...]
+  rename <old> <new>              rename
+  remove <name>                   remove
+  <name> run                      launch (sugar for fnl claude)
+  <name>                          launch (alias for run)
+
+examples:
+  funnel profiles add cto --channel prod-inbox --repo myapp --sub-agent cto
+  funnel profiles cto run`