Deploy managed agents (agentlift)
This repo defines deployable agents under .managed-agents/. Use the agentlift
CLI to push them to Anthropic's Managed Agents cloud and run them by ID. The user
shouldn't need to learn it — translate their intent into the right command.
Prerequisite: pip install agentlift and ANTHROPIC_API_KEY set (it's in .env).
What the user wants -> what to run
- "show me what would deploy" / "dry run" ->
agentlift plan . - "is this valid?" ->
agentlift validate .(exit 1 means there are errors to fix) - "deploy" / "ship to the cloud" ->
agentlift deploy . --yes- then report the agent IDs printed, and that
.agentlift-lock.jsonwas written.
- then report the agent IDs printed, and that
- "redeploy" / "I changed an agent" ->
agentlift deploy . --yes --prune- idempotent: unchanged skills/agents are skipped automatically.
- "run with " ->
agentlift run <agent> --project . --task "<task>" - "run it locally" / "same agent on my machine" -> add
--local - "what's deployed?" ->
agentlift list . - "tear it down" / "delete the agents" ->
agentlift destroy . --yes
Rules
- Always run
agentlift plan .first and show the user the plan beforedeploy. Surface anyERRORdiagnostics (e.g. a stdio MCP server, which can't deploy) and stop — don't pass--skip-unsupportedunless the user agrees to drop those. - After deploying, the
.agentlift-lock.jsonmaps each agent to its remote ID. Tell the user to commit it so re-deploys are idempotent andrunworks for the whole team. - Never put
ANTHROPIC_API_KEYon the command line or in a committed file.