a2a_pack.cli.main

a2a CLI: scaffold, validate, build, deploy.

auth_api_key (function)

auth_api_key(agent: 'str', value: 'str', name: 'str', location: 'str', scheme_name: 'str | None', api: 'str | None') -> 'None'

Connect API-key auth for an imported agent.

auth_bearer (function)

auth_bearer(agent: 'str', token: 'str', scheme_name: 'str | None', scheme: 'str', api: 'str | None') -> 'None'

Connect HTTP/Bearer auth for an imported agent.

auth_delete (function)

auth_delete(agent: 'str', connection_id: 'int', api: 'str | None') -> 'None'

Remove an imported-agent auth connection.

auth_mtls (function)

auth_mtls(agent: 'str', cert: 'Path', key: 'Path', ca: 'Path | None', scheme_name: 'str | None', api: 'str | None') -> 'None'

Connect mTLS client certificate auth for an imported agent.

auth_oauth_token (function)

auth_oauth_token(agent: 'str', access_token: 'str', scheme_type: 'str', scheme_name: 'str | None', refresh_token: 'str | None', token_url: 'str | None', client_id: 'str | None', client_secret: 'str | None', expires_in: 'int | None', api: 'str | None') -> 'None'

Connect OAuth/OIDC with an existing access token and optional refresh config.

auth_status (function)

auth_status(agent: 'str', api: 'str | None') -> 'None'

Show detected auth requirements and configured connections.

build (function)

build(project: 'Path', registry: 'str', push: 'bool') -> 'None'

Build (and optionally push) the container image for the agent.

build_frontend (function)

build_frontend(project: 'Path') -> 'None'

Build the packed frontend declared in a2a.yaml.

card (function)

card(project: 'Path') -> 'None'

Print the Agent Card JSON for the project's agent.

deploy (function)

deploy(project: 'Path', public: 'bool | None', wait: 'bool', api: 'str | None') -> 'None'

Ship the agent.

Tarballs your source, uploads to the control plane, and prints the URL when it's live. No local docker. No git. No knowledge of how the platform builds or deploys.

dev (function)

dev(project: 'Path', host: 'str', port: 'int', reload: 'bool', env_file: 'Path', workspace: 'Path | None') -> 'None'

Run the agent locally with .env.local, workspace, and hot reload.

frontend_info (function)

frontend_info(project: 'Path') -> 'None'

Print the packed frontend config resolved from a2a.yaml.

generate_openapi (function)

generate_openapi(url: 'str', name: 'str | None', description: 'str | None', base_url: 'str | None', public: 'bool', api: 'str | None') -> 'None'

Generate an editable A2APack source repo and start deployment.

import_agent (function)

import_agent(url: 'str', name: 'str | None', public: 'bool', auth_bearer: 'str | None', auth_api_key: 'str | None', auth_name: 'str | None', auth_location: 'str', auth_scheme: 'str', api: 'str | None') -> 'None'

Import an already-running A2A agent into the registry.

init (function)

init(name: 'str', description: 'str', target: 'Path', frontend: 'str | None', auth: 'str') -> 'None'

Scaffold a new agent project.

list_agents (function)

list_agents(api: 'str | None') -> 'None'

List agents visible to the current user.

login (function)

login(email: 'str', password: 'str', api: 'str') -> 'None'

Authenticate with the control plane and cache the JWT.

logout (function)

logout() -> 'None'

Forget the cached JWT.

mcp_url (function)

mcp_url(name: 'str | None', project: 'Path', api: 'str | None') -> 'None'

Print the MCP connect config for a deployed agent.

Every shipped agent auto-exposes POST /mcp (Streamable HTTP). This command prints the JSON snippet you paste into Claude Code, Cursor, or any other MCP client to wire up the agent.

preview_openapi (function)

preview_openapi(url: 'str', name: 'str | None', description: 'str | None', base_url: 'str | None', public: 'bool', api: 'str | None') -> 'None'

Preview generated skills, setup fields, and source files.

run (function)

run(entrypoint: 'str', host: 'str', port: 'int', project: 'Path') -> 'None'

Run the agent's HTTP server locally (used inside the container too).

signup (function)

signup(email: 'str', password: 'str', api: 'str') -> 'None'

Create an account on the control plane and store the JWT locally.

test_agent (function)

test_agent(project: 'Path', env_file: 'Path', workspace: 'Path | None', invoke: 'bool', skill: 'str | None', args_json: 'str | None') -> 'None'

Run local preflight checks before deploying.

validate (function)

validate(project: 'Path') -> 'None'

Load the agent and print its Card schema. Exits non-zero on errors.

whoami (function)

whoami() -> 'None'

Show the currently logged-in user.

Source: apps/a2a/a2a_pack/cli/main.py