FuturePath CLI

Terraform-like CLI for managing DeepAgents platform resources declaratively.

Define credentials, datasets, MCP servers, agents, and triggers in YAML manifests, then apply them consistently across environments.

Installation

pip install --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ futurepath-cli

Or with pipx for isolated installation:

pipx install futurepath-cli --pip-args="--index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/"

Upgrade

Upgrade to the latest version:

# Using pip
pip install --upgrade --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ futurepath-cli

# Using pipx
pipx upgrade futurepath-cli --pip-args="--index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/"

Quick Start

# 1. Check available environments
fp env list

# 2. Login to an environment
fp login local -e admin@example.com -p yourpassword
# Or login to dev/staging/prod:
fp login dev -e admin@example.com -p yourpassword

# 3. List existing resources
fp list agents              # List all agents
fp list datasets            # List all datasets
fp list credentials         # List all credentials

# 4. Apply a manifest
fp apply -f my-workspace.yaml --auto-approve

# 5. Check state
fp state --name my-workspace

# 6. Get a specific resource
fp get agent my-agent       # Get agent details

# 7. Interact with agents directly
fp agent chat my-chat-agent "What can you help me with?"
fp agent run my-automation-agent --task "Analyze incidents"

# 8. Destroy resources when done
fp destroy --name my-workspace --auto-approve

Commands

Manifest Format

apiVersion: deepagents/v1
kind: WorkspaceBundle
metadata:
  name: my-workspace
  version: "1.0"
  description: "Production ServiceNow integration"

variables:
  servicenow_instance:
    type: string
    required: true

definitions:
  credentials:
    servicenow-prod:
      name: "ServiceNow Production"
      type: servicenow
      secrets:
        instance: "${servicenow_instance}"
        username: "${SERVICENOW_USER}"
        password: "${SERVICENOW_PASS}"

  datasets:
    alerts-dataset:
      name: "Monitoring Alerts"
      source_type: upload
      file_path: data/alerts.csv
      file_type: csv
      # Pre-define schema for auto-finalization (status: ready)
      field_configs:
        - field_name: alert_id
          field_type: VARCHAR
          display_name: "Alert ID"
        - field_name: severity
          field_type: VARCHAR
          description: "Alert severity level"

  agents:
    incident-triage:
      name: "Incident Triage Bot"
      agent_type: automation
      model: claude-sonnet-4-20250514
      instructions: "You are an IT support expert..."
      datasets: ["@alerts-dataset"]

State Management

By default, state is stored in the database with:

• Locking: Prevents concurrent modifications
• Audit History: All changes tracked
• Team Collaboration: State accessible from any machine

Use --local-state for local file storage.

Environment Variables

Secrets should use environment variables in manifests:

secrets:
  api_key: "${MY_API_KEY}"  # Reads from MY_API_KEY env var

Documentation

For full documentation, see FuturePath CLI Guide.

License

MIT License - see LICENSE for details.