OpenMed Agent

AI-powered medical assistant for the terminal — private, sandboxed, and built for clinical workflows

curl -fsSL https://agent.openmed.life/install.sh | bash

Features

Sandboxed Execution
All tool calls run in a controlled environment with explicit user approval.
HIPAA/GDPR-Aware
Full, de-identified, and strict PHI handling modes for regulatory compliance.
Local-First Privacy
Patient data stays on your machine. No telemetry, no analytics.
Clinical Workflows
Generate PA letters, extract entities, look up LCD/NCD criteria, export PDFs.
MCP Integration
Connect to PubMed, ICD-10, NPI, and CMS databases for real-time evidence.
Self-Update
Built-in binary update mechanism with SHA-256 verification.

Installation

Download the latest binary (macOS & Linux):

curl -fsSL https://agent.openmed.life/install.sh | bash

Or install via pip:

pip install openmed-agent[tui]

CLI Reference

openmed 
usage: openmed [-h] [--version] [--config-path CONFIG_PATH]
               [--agent {clinical,plan,default}] [--mcp-enabled]
               {tui,agent,config,login,oauth,codex,mcp,update} ...

OpenMed Agent — AI-powered medical assistant with TUI.

positional arguments:
  {tui,agent,config,login,oauth,codex,mcp,update}
    tui                 Launch interactive terminal UI for clinical NER
                        analysis.
    agent               Launch OpenMed Agent TUI - AI-powered medical
                        assistant.
    config              Inspect or modify OpenMed CLI configuration.
    login               Authenticate for Codex via OAuth.
    oauth               Manage Codex OAuth authentication.
    codex               Codex authentication and management.
    mcp                 Manage remote MCP server connectors.
    update              Update OpenMed to the latest version.

options:
  -h, --help            show this help message and exit
  --version             show program's version number and exit
  --config-path CONFIG_PATH
                        Override the configuration file path.
  --agent {clinical,plan,default}
                        Agent mode for the TUI (clinical or plan).
  --mcp-enabled         Enable all supported remote MCP servers before running
                        the command. This persists in MCP config.
openmed agent 
usage: openmed agent [-h] [--model MODEL]
                     [--reasoning-effort {low,medium,high,extra_high}]
                     [--agent {clinical,plan,default}] [--skill SKILL]
                     [--phi-mode {full,deid,strict}] [--provider {openai}]
                     [--once PROMPT]

options:
  -h, --help            show this help message and exit
  --model MODEL         LLM model to use (default: gpt-5.4).
  --reasoning-effort {low,medium,high,extra_high}
                        Reasoning depth for supported models (default: low).
  --agent {clinical,plan,default}
                        Agent mode to use (clinical or plan).
  --skill SKILL         Skill to activate (e.g. analyzing-clinical-text).
                        Default: none.
  --phi-mode {full,deid,strict}
                        PHI handling mode: full (no restrictions), deid (de-
                        identify before external), strict (no PHI leaves
                        local).
  --provider {openai}   LLM provider (default: openai).
  --once PROMPT         Run single-shot mode with the given prompt (non-
                        interactive).
openmed config 
usage: openmed config [-h]
                      {show,set,profiles,profile-show,profile-use,profile-save,profile-delete}
                      ...

positional arguments:
  {show,set,profiles,profile-show,profile-use,profile-save,profile-delete}
    show                Display active configuration.
    set                 Persist a configuration value.
    profiles            List available configuration profiles.
    profile-show        Show settings for a specific profile.
    profile-use         Apply a profile to the current configuration.
    profile-save        Save current configuration as a named profile.
    profile-delete      Delete a custom profile.

options:
  -h, --help            show this help message and exit
openmed mcp 
usage: openmed mcp [-h] {list,enable,disable,add,remove,set-url,doctor} ...

positional arguments:
  {list,enable,disable,add,remove,set-url,doctor}
    list                List MCP server configuration.
    enable              Enable an MCP server.
    disable             Disable an MCP server.
    add                 Add a new MCP server.
    remove              Remove an MCP server.
    set-url             Override MCP server URL.
    doctor              Check connectivity and tool discovery for MCP servers.

options:
  -h, --help            show this help message and exit
openmed update 
usage: openmed update [-h] [--check] [--force]

options:
  -h, --help  show this help message and exit
  --check     Only check for updates, don't install.
  --force     Bypass the version cache and query GitHub.