L Lift CLI Docs
CLI Home

lift agent

Generate AI agent skill files so coding agents (Claude Code, Cursor, etc.) can autonomously manage your server using Lift CLI.

lift agent

Generate AI-ready skill files so coding agents can autonomously manage your server using Lift CLI. The generated file teaches any AI agent how to use every Lift command, discover tools from the catalog, and manage your infrastructure.

Subcommands

lift agent init

Generate a comprehensive skill/reference file for AI agents. Can be run multiple times to refresh server context.

FlagDescriptionDefault
--output, -oOutput file path.claude/skills/lift-cli.md
# Generate skill file (default: .claude/skills/lift-cli.md)
lift agent init

# Write to Cursor rules
lift agent init --output .cursorrules

# Write to a custom path
lift agent init --output my-skill.md

The generated file includes:

  • Command reference — all 60+ commands with flags and examples
  • Workflow patterns — common multi-step tasks (setup, install, diagnose, backup, scale)
  • Tool discovery — how to search the catalog by keyword
  • JSONL output format — how to parse structured output
  • Error handling — common errors and recovery patterns
  • Dynamic server context — installed tools, domains, server IP (collected at generation time)

What happens when you run it

  1. Reads .lift.json for server connection info
  2. Connects via SSH and collects installed tools, active domains
  3. Generates a self-contained markdown file with the full CLI reference + server context
  4. Shows check results:
  [OK] .lift.json found (server: 1.2.3.4)
  [OK] SSH connection works
  [OK] 3 tool(s) installed
  [OK] 2 domain(s) active
  Skill file written to .claude/skills/lift-cli.md

Usage with AI Tools

Claude Code

# Default path is already .claude/skills/lift-cli.md
lift agent init

Cursor

lift agent init --output .cursorrules

Other AI Tools

The generated file is standard markdown. Provide it as context to any AI coding assistant.

Refreshing

Re-run lift agent init anytime after installing/removing tools or changing domains. It regenerates the full file with fresh server context.

  • lift catalog - Browse available tools (used by agents for tool discovery)
  • JSONL Output - Understanding structured output format
  • lift init - Initialize project (first step before agent setup)
Previouslift licenseNextlift clone