The command line client for Vivgrid, the Enterprise-grade AI Agent Platform.

Install the compiled binary:

curl "https://bina.egoist.dev/vivgrid/cli?file=viv&name=viv" | sh

make

sudo cp ./bin/viv /usr/local/bin/

viv --help

The viv CLI tool allows you to manage globally deployed Serverless LLM Functions on Vivgrid. It provides a complete workflow for developing, deploying, and monitoring LLM Tools in serverless.

You can configure viv using a configuration file or command-line flags:

Configuration file (vivgrid.yml):

secret: your_app_secret
tool: my_first_llm_tool

Environment variable for config file location:

export VIV_CONFIG_FILE=/path/to/your/vivgrid.yml

• --secret string: App secret for authentication
• --tool string: Serverless LLM Function name (Optional, default "my_first_llm_tool")
• --api string: REST API endpoint (Optional, default "https://hosting.vivgrid.com")

One-command deployment that chains: upload → remove → create

Examples:

# Deploy current directory
viv deploy .

Upload and compile your source code to the vivgrid platform.

Supported source formats:

• Directories - Will be automatically zipped (respects .gitignore)
• .zip files - Pre-packaged zip archive
• .go files - Single Go source file

Examples:

# Upload a directory (auto-zips with exclusions)
viv upload ./my-function-dir

Auto-exclusions when uploading directories:

• .git/ - Git repository directory
• .vscode/ - VS Code settings
• .DS_Store - macOS system files
• .env - Environment files
• Files matching patterns in .gitignore

Flags:

• --env key=value: Set environment variables (can be used multiple times)

Create and start a serverless deployment from previously uploaded code.

Examples:

# Create deployment
viv create

# Create with environment variables
viv create --env DATABASE_URL=postgres://... --env API_KEY=secret

Flags:

• --env key=value: Set environment variables (can be used multiple times)

Delete the current serverless deployment.

viv remove

Show the current status of your serverless deployment.

viv status

Output includes:

• Deployment status
• Start time
• Global deployments

Observe serverless logs in real-time.

viv logs

Show the current version of the viv CLI tool.

viv version

For more detailed documentation, visit the Vivgrid Developer Docs.