tinyhumansai/openhuman · warning

unknown dump-prompt arg: {other}

Error message

unknown dump-prompt arg: {other}

What it means

Thrown by parse_dump_flags when a token of `openhuman agent dump-prompt` matches none of --agent/-a, --toolkit/-t, --workspace/-w, --model/-m, --json, --with-tools, -v/--verbose, -h/--help. The parse aborts on the first unrecognized token.

Source

Thrown at src/core/agent_cli.rs:219

                i += 2;
            }
            "--json" => {
                out.json = true;
                i += 1;
            }
            "--with-tools" => {
                out.with_tools = true;
                i += 1;
            }
            "-v" | "--verbose" => {
                out.verbose = true;
                i += 1;
            }
            "-h" | "--help" => {
                print_dump_prompt_help();
                std::process::exit(0);
            }
            other => return Err(anyhow!("unknown dump-prompt arg: {other}")),
        }
        let _ = i; // silence unused-warning in the `help` branch
    }
    Ok(out)
}

fn run_dump_prompt(args: &[String]) -> Result<()> {
    let flags = parse_dump_flags(args)?;
    let agent = flags.agent.clone().ok_or_else(|| {
        anyhow!("--agent <id> is required (e.g. `orchestrator`, `integrations_agent`, `welcome`)")
    })?;

    if agent == "integrations_agent" && flags.toolkit.is_none() {
        return Err(anyhow!(
            "--toolkit <slug> is required when --agent is `integrations_agent` \
             (e.g. `--toolkit gmail`). Run `composio list_connection` to see active slugs."
        ));
    }

View on GitHub (pinned to a221052e0d)

Solutions

1. Run `openhuman agent dump-prompt --help` and use only the listed flags.
2. Look one token back: an unknown-arg error often means the previous flag's value was omitted.
3. Prefer the exact long spellings (--agent, --toolkit, --workspace, --model, --json, --with-tools).

Example fix

# before
openhuman agent dump-prompt --agents orchestrator

# after
openhuman agent dump-prompt --agent orchestrator

const DUMP_PROMPT_FLAGS: &[&str] = &["--agent", "-a", "--toolkit", "-t", "--workspace", "-w", "--model", "-m", "--json", "--with-tools", "-v", "--verbose", "-h", "--help"];
// sanity-check tokens before invoking
for t in &args[2..] {
    if t.starts_with('-') && !DUMP_PROMPT_FLAGS.contains(&t.as_str()) {
        eprintln!("unrecognized flag {t}; see openhuman agent dump-prompt --help");
    }
}

match run_agent_command(&args) {
    Err(e) if e.to_string().contains("unknown dump-prompt arg") => {
        print_dump_prompt_help();
    }
    other => other?,
}

When it happens

Trigger: Typo'd flags (`--agents`, `--toolkits`, `--format`), stray positional arguments, or a value-consuming flag missing its value so a later token lands in the unknown arm.

Common situations: Guessing flag names, using dump-all-style flags on dump-prompt, or copy-pasting from mismatched documentation/CI scripts.

Related errors

• unknown dump-all arg: {other}
• unknown list arg: {other}
• unknown agent subcommand '{other}'. Run `openhuman agent --h
• missing value for --out
• missing value for --workspace

AI-assisted analysis of tinyhumansai/openhuman@a221052e0d (2026-08-16). Data as JSON: /api/errors/65c4223b487cc455. Report an issue: GitHub.