Apteva CLI

An interactive command-line interface for Apteva's AI agent platform. Build, manage, and chat with AI agents directly from your terminal.

Features

• 🚀 Interactive Navigation - Beautiful terminal UI with arrow key navigation
• 🔐 Authentication - Secure login and account creation
• 📦 Project Management - Browse and organize your AI projects
• 🤖 Agent Management - Create, edit, and configure AI agents
• 💬 Real-time Chat - Interactive conversations with your agents
• 📋 Task Management - Create and track agent tasks
• 🔑 Credential Management - Secure API key and credential handling

Installation

Install globally via npm:

npm install -g @apteva/cli

Or run directly with npx:

npx @apteva/cli

Quick Start

1. Install the CLI:

npm install -g @apteva/cli

2. Launch the application:

apteva

3. First time setup:
   • If you have an account: Sign in with your email and password
   • New user: Press S to create a new account
   • Your credentials will be securely stored for future sessions

Basic Commands

apteva              # Launch the interactive CLI
apteva --signup     # Start in account creation mode
apteva --logout     # Sign out and clear stored credentials
apteva --help       # Show all available options

Usage

Navigation Controls

• ↑↓ Arrow keys - Navigate through menus and lists
• ↵ Enter - Select an item or confirm action
• Tab - Move to next form field during login/signup
• S - Switch between login and signup modes
• ESC - Go back to previous screen or exit
• ? - Show context-specific help

Workflow Overview

1. Authentication - Sign in or create your account
2. Project Selection - Choose or create a project workspace
3. Agent Management - Build and configure your AI agents
4. Interactive Chat - Test and refine your agents through conversation
5. Task Management - Organize agent workflows and assignments
6. Credential Setup - Manage API keys for external integrations

Getting Help

• In-app help: Press ? while using the CLI for context-specific help
• Command help: Run apteva --help for all available options
• Documentation: Visit apteva.ai for comprehensive guides
• Issues: Report bugs at github.com/apteva/apteva-cli/issues

Troubleshooting

Login Issues

• Double-check your email and password
• Try creating a new account if you don't have one
• Use apteva --logout to clear stored credentials and try again

Connection Problems

• Ensure you have a stable internet connection
• Check if you're behind a corporate firewall
• Try restarting the CLI

Other Issues

• Run apteva --logout to reset your session
• Update to the latest version: npm update -g @apteva/cli
• Clear npm cache if needed: npm cache clean --force

License

MIT