Skip to content

CLI Reference

CommandDescription
installRegister with an MCP client (claude, copilot)
accept-eulaAccept the Work IQ EULA
ask -q "..."Ask Microsoft 365 Copilot a question
mcpStart MCP proxy server (stdio)
serveStart OpenAI-compatible HTTP API (localhost)
webOpen browser-based terminal UI
jsonInteractive JSON-RPC testing mode
versionShow component versions
licensesPrint license and third-party disclosures
helpShow help

These are the commands most people need:

CommandDescription
workiq-proxyStart an interactive chat session
workiq-proxy install claudeRegister with Claude Code
workiq-proxy install copilotRegister with GitHub Copilot
workiq-proxy accept-eulaAccept the Work IQ EULA
workiq-proxy ask -q "..."Ask a question directly
FlagDefaultDescription
--jsonfalseEmit JSONL to stderr instead of pretty-printed logs (serve/web modes)
--log-file(none)Override log file path (default: $XDG_STATE_HOME/workiq-proxy/workiq-proxy.log)
--no-logfalseDisable traffic logging
--port11435Port for serve mode (seeks next available if busy)
--tlsfalseEnable TLS with an auto-generated self-signed certificate for localhost
--workiq-cmdnpx -y @microsoft/workiqBase command to reach the Work IQ CLI

When running in interactive mode (no arguments), these slash commands are available:

CommandDescription
/emails [opts]Search emails (from: subject: date:)
/docs [opts]Search documents (name: site: type:)
/chats [opts]Search chats (with: date:)
/channels [opts]Search channels (team: channel: date:)
/meetings [opts]Search meetings (by: subject: date:)
/people [opts]Search people (name: dept: project:)
/accept-eulaAccept the Work IQ EULA
/title <name>Set terminal/tab title
/toolsList available MCP tools
/helpShow available commands
/quitExit
ConditionBehavior
No arguments, interactive terminalLaunches the interactive REPL
No arguments, piped stdin (no TTY)MCP proxy mode (how MCP clients invoke it)
mcp subcommandMCP proxy mode (explicit)
serve subcommandOpenAI-compatible HTTP API on localhost
web subcommandBrowser-based terminal UI
json subcommandInteractive JSON-RPC testing
Any other argumentsPassed through to the Work IQ CLI
Terminal window
workiq-proxy --workiq-cmd workiq
Terminal window
workiq-proxy --no-log
Terminal window
workiq-proxy --log-file /tmp/workiq-debug.log
Terminal window
workiq-proxy serve --port 9000