API Documentation
infosec CLI
An autonomous offensive-security agent in your terminal — recon, vulnerability discovery, and exploitation workflows powered by uncensored models. Install in one command.
Install
Native install on macOS and Linux; Windows via PowerShell.
macOS
Apple Silicon + Intel
Linux
x86_64 + arm64
Windows
PowerShell or WSL2
macOS / Linux
curl -fsSL https://uncensored.chat/infosec.sh | shWindows (PowerShell)
irm https://uncensored.chat/infosec.ps1 | iexSign in and run
infosec login opens your browser to approve the CLI against your account (a verified email is required). Then start the agent:
infosec login
infosec whoami
infosec usage
infosec "explain this codebase"Models
Pick per run with
-m, in the TUI with /model, or set a default in config.| Model | Use case | Context | Reasoning |
|---|---|---|---|
kimi-k3defaultAgentic coding, tool use, and security engineering. 1M context. | coding | 1M | max |
glm-5.2General coding, tool use, and security engineering. 1M context. | coding | 1M | low / medium / high |
Set a default in ~/.infosec/config.toml
model = "kimi-k3"
model_reasoning_effort = "medium" # low / medium / high (where supported)The catalog is managed server-side, so new models appear for signed-in users as soon as they go live.
Usage & quota
Metered in CLI tokens per month; resets monthly. Check yours with
infosec usage.| Plan | Monthly tokens | ×Basic |
|---|---|---|
| Basic Planbaseline | 1M | 1× |
| Standard Plan | 10M | 10× |
| Premium Plan | 100M | 100× |
Commands
Everything that shows up in infosec --help.
Everyday use
infosec | Start the interactive TUI (optional prompt: infosec "explain this repo"). |
infosec exec / infosec e | Run one shot non-interactively. |
infosec review | Run a code review non-interactively. |
infosec login | Sign in to your uncensored.chat account. |
infosec login status | Show login status. |
infosec logout | Sign out / clear stored credentials. |
infosec whoami | Show the signed-in account. |
infosec usage | Show plan usage and remaining quota. |
infosec update | Update the CLI to the latest release. |
infosec doctor | Diagnose install, config, auth, and runtime health. |
infosec --version | Print the version. |
infosec --help | Print help. |
Sessions
infosec resume | Resume a previous session (picker, or --last). |
infosec fork | Fork a previous session. |
infosec archive <session> | Archive a saved session. |
infosec unarchive <session> | Unarchive a session. |
infosec delete <session> | Permanently delete a session. |
Other
infosec apply / infosec a | Apply the latest agent diff with git apply. |
infosec completion | Generate shell completion scripts. |
infosec sandbox | Run a command inside the sandbox. |
infosec features | Inspect feature flags. |
infosec debug | Debugging helpers (e.g. models dump). |
Experimental (visible, not yet stable)
infosec app-serverinfosec remote-controlinfosec cloudinfosec exec-serverinfosec app (desktop)Common options
Flags for the interactive and exec runs.
-m, --model <MODEL> | Choose the model for the run. |
-C, --cd <DIR> | Working directory for the agent. |
--add-dir <DIR> | Extra writable directory. |
-i, --image <FILE> | Attach image(s) to the first prompt. |
-c, --config key=value | Override config for this run. |
-a, --ask-for-approval <policy> | Approval policy (untrusted / on-request / never). |
--search | Enable live web search (when the provider supports it). |
Extend it
Plugins and MCP servers.
Plugins
infosec plugin list | List available / installed plugins. |
infosec plugin add <name> | Install a plugin from a marketplace. |
infosec plugin remove <name> | Remove an installed plugin. |
infosec plugin doctor | Check plugin prerequisites / health. |
infosec plugin marketplace | Add / list / upgrade / remove marketplaces. |
MCP
infosec mcp list | List configured MCP servers. |
infosec mcp get | Show one MCP server. |
infosec mcp add | Add an MCP server. |
infosec mcp remove | Remove an MCP server. |
infosec mcp login / logout | MCP server auth helpers. |
infosec mcp-server | Run infosec itself as an MCP server (stdio). |