🚀 Agentis Cloud CLI

Agentis Cloud CLI (agentis-cloud-cli) is a powerful command-line interface designed for the Agentis/Tomris ecosystem. This tool allows you to deploy code from your local directory as an Agent or a Tool to the cloud in seconds.

🌟 Key Features

• Effortless Deployment: Go live with a single command from any directory containing an agentis.yaml and a Dockerfile.
• Automatic Scheduling: No need to manually select a target machine anymore; the backend automatically schedules your deployment to the best available worker node.
• Headless & CI/CD Support: Support for Personal Access Tokens (PAT) and the AGENTIS_TOKEN environment variable allows you to run deployments in headless servers and CI/CD pipelines without browser interactions.
• Flexible Configuration: Easily override metadata like name, description, and port during deployment.
• Ignore File Support: Take full control over uploaded files using .agentisignore.

📦 Installation

Install the CLI globally on your system using npm:

npm install -g agentis-cloud-cli

Once installed, both the agentis and agentis-cloud commands will be available from your terminal.

🔑 Getting Started & Authentication

1. Browser Login (Standard)

Authorize the CLI with your Tomris OAuth account:

agentis login

This command opens your default web browser for OAuth authorization.

2. Token-Based Login (Headless / Remote Server)

Authenticate without opening a web browser using a Personal Access Token (PAT) generated from the web dashboard under Credentials & Keys:

agentis login --token YOUR_PERSONAL_ACCESS_TOKEN

3. CI/CD Pipeline Integration (Zero-Login)

For continuous integration pipelines (e.g., GitHub Actions, GitLab CI), simply define the token as an environment variable, and the CLI will automatically authenticate:

export AGENTIS_TOKEN="YOUR_PERSONAL_ACCESS_TOKEN"
# Now you can run deploy directly without logging in:
agentis deploy --agent

4. Check Profile

Verify your active session:

agentis whoami

5. Logout

Clear local session tokens:

agentis logout

🚢 Deployment

Deploy your workspace code directly as an Agent or a Tool.

Requirements

Your project directory must contain:

1. Dockerfile: Defines how your application is containerized.
2. agentis.yaml: Contains metadata for the Agent or Tool.

Sample agentis.yaml:

name: "my-smart-agent"
description: "This agent solves complex tasks using AI."
version: "1.0.0"
port: 3000
endpoint: "/chat"
inputs:
  - name: "query"
    type: "string"
outputs:
  - name: "response"
    type: "string"

Deployment Commands

To deploy as an Agent:

agentis deploy --agent

To deploy as a Tool:

agentis deploy --tool

Optional Flags

Override agentis.yaml values directly:

• --name: Changes the Agent/Tool display name.
• --description: Updates the description.
• --port: Overrides the internal container port.

Example:

agentis deploy --agent --name "fast-assistant" --port 8080

.agentisignore File

To exclude specific directories or files (like node_modules, .git, or .env) from being packaged, create an .agentisignore file in your project root. It follows the standard .gitignore format.

⚙️ Configuration Hierarchy

The CLI checks for credentials in the following order:

1. Environment variables (AGENTIS_TOKEN, AGENTIS_CLIENT_ID, AGENTIS_CLIENT_SECRET)
2. Command-line options (--token, --client-id, --client-secret)
3. Local configuration store (~/.config/configstore/agentis-cli.json)

📄 License

This project is licensed under the ISC License.

Developed with ❤️ by the24s Technology