Portal CLI

Command-line tools for deploying Portal agent configurations.

Install

npm install -g @useportal/cli

Or run without installing:

npx @useportal/cli

Configure

Set your Portal secret API key:

portal config set api-key sk_...

Set your LLM provider key once:

portal config set llm-key sk-ant-...

The LLM key is sent to Portal and stored on your account. It is not stored locally.

Define Agents

Create portal.config.ts in your project root:

export default {
  environmentId: "env_xxx",
  agents: {
    "support-agent": {
      name: "Support Agent",
      model: "anthropic/claude-sonnet-4-20250514",
      instructions: "You are a helpful support assistant.",
      tools: {},
    },
  },
};

Deploy

portal deploy

Or specify the environment directly:

portal deploy --environment env_xxx

Commands

portal deploy
portal config set api-key <key>
portal config set llm-key <key>
portal config set api-url <url>
portal config get
portal whoami

Configuration Resolution

API key priority:

PORTAL_API_KEY
local CLI config

API URL priority:

PORTAL_API_URL
local CLI config
https://api.useportal.co

Environment priority:

--environment
portal.config.ts environmentId

Development

pnpm install
pnpm build

License

MIT