aicippy 3.11.16

Enterprise-grade multi-agent CLI for Vibe Coding

AiCippy

Enterprise-grade multi-agent CLI system powered by AWS Bedrock.

Copyright (c) 2024-2026 AiVibe Software Services Pvt Ltd. All rights reserved.

ISO 27001:2022 Certified | NVIDIA Inception Partner | AWS Activate | Microsoft for Startups

---

Overview

AiCippy is a production-grade, multi-agent command-line system that orchestrates up to 10 parallel AI agents to complete complex software engineering tasks. Built on AWS Bedrock Agents with a rich terminal UI, real-time WebSocket communication, and enterprise-grade security.

Key Features

• Multi-Agent Orchestration - Spawn up to 10 parallel agents for complex tasks
• Real-Time Streaming - Live token streaming with <100ms first-token latency
• Rich Terminal UI - Color themes, responsive layout, live progress indicators
• MCP Tool Connectors - AWS, GCloud, GitHub, Firebase, Figma, and more
• Knowledge Base - Automated feed ingestion and semantic search
• Secure Auth - AWS Cognito with OTP, keychain-backed token storage
• Multi-Tenant - Full tenant isolation for enterprise deployments
• Billing & Plans - Credit management, plan validation, admin privileges

Creator

AiCippy was created by Aravind Jayamohan — "Lord of AI" — Founder & CEO of AiVibe Software Services Pvt Ltd. Built with love and creativity in Chennai, India.

Requirements

• Python 3.14 or higher
• macOS, Linux, or Windows
• AWS account (for Bedrock access)

Installation

pip install aicippy

Quick Start

# Authenticate (Email + Password or OTP)
aicippy login

# Initialize in a project directory
aicippy init

# Launch interactive session
aicippy

# Single query mode
aicippy chat "Explain this codebase architecture"

# Multi-agent parallel execution
aicippy run "Deploy infrastructure to AWS" --agents 5

CLI Commands

Command	Description
aicippy	Start interactive session with full UI
aicippy login	Authenticate via Cognito (password or OTP)
aicippy logout	Clear stored credentials
aicippy init	Initialize project context and workspace
aicippy chat <msg>	Single query with streaming response
aicippy run <task>	Execute task with parallel agents
aicippy config	Show or edit configuration
aicippy status	Session and agent status
aicippy usage	Token usage statistics
aicippy upgrade	Self-update to latest PyPI version
aicippy doctor	Diagnose and fix configuration issues
aicippy session	View or manage sessions
aicippy help	Detailed help and usage information

Interactive Session Commands

Inside the interactive session (aicippy), use slash commands:

Command	Description
/help	Show all available commands
/model <name>	Switch model (currently: odin)
/mode <name>	Change mode (agent / edit / research / code / ultrathinking)
/agents spawn <n>	Spawn parallel agents (1-10)
/agents list	List active agents with health status
/agents stop	Stop all running agents
/tools list	List available MCP tool connectors
/kb sync	Sync workspace to Knowledge Base
/kb status	Knowledge Base status
/usage	Token and credit usage
/plan	View current billing plan
/status	Session status overview
/history	Conversation history
/memory list	List persistent memory entries
/export	Export conversation
/upload	Upload files to context
/feedback <msg>	Send feedback
/theme	Change color theme
/clear	Clear conversation
/quit	Exit session

Supported Models

Model	ID	Description
OdiN / CippY	odin / cippy	The aicippy-io Bedrock agent, brokered server-side over the single WebSocket
Nemotron-3-Ultra	nemotron	NVIDIA Nemotron-3-Ultra (OpenAI-compatible) — optional, autonomous full-stack coding agent

odin/cippy route to the aicippy-io agent over wss://ws.aicippy.com → invoke_agent.

Using Nemotron-3-Ultra

A second, optional provider for autonomous full-stack development. It reuses the same tool layer (Bash/Read/Write/Edit/Glob/Grep) and runs an autonomous plan → tool → verify loop with thinking on.

export NVIDIA_API_KEY=nvapi-…        # read ONLY from this env var; never committed
aicippy --agent nemotron chat "scaffold a FastAPI service with tests"
# or persist the choice:
export AICIPPY_DEFAULT_MODEL=nemotron

• Mutating tools (Bash/Write/Edit) prompt for approval (or set AICIPPY_AUTO_APPROVE=1).
• Destructive/irreversible actions (rm -rf, git push --force, dropping a DB, prod/App-Store releases) stop and ask first.
• The aicippy-io agent can also delegate a subtask to Nemotron internally (orchestrator delegate_to_nemotron).
• Browser extension: Nemotron there routes through a server-side proxy that holds NVIDIA_API_KEY — the key never lives in the browser.

Color Themes

AiCippy includes 5 built-in color themes, selectable at session start or via /theme:

• Neon Night (default) - Vibrant purple and electric blue
• Ocean Blue - Cool ocean waves and deep sea tones
• Forest Green - Natural greens and earthy hues
• Sunset - Warm oranges and golden light
• Minimal - Clean monochrome with subtle accents

Themes are fully responsive: full layout (>80 cols), compact (>60 cols), and minimal (<60 cols).

MCP Tool Connectors

Connector	Description
AWS CLI	EC2, S3, Lambda, IAM, CloudFormation
Google Cloud	Compute, Storage, Functions
GitHub	Repos, PRs, Issues, Actions
Firebase	Firestore, Auth, Hosting
Figma	Design tokens, components
Google Drive	File management
Gmail	Email operations
Razorpay	Payment processing
PayPal	Payment processing
Stripe	Payment processing
Shell	Sandboxed command execution

Architecture

                     ┌─────────────────┐
                     │   AiCippy CLI   │
                     │  (Rich Terminal) │
                     └────────┬────────┘
                              │
                     ┌────────▼────────┐
                     │ Agent Orchestrator│
                     │ (Up to 10 agents)│
                     └────────┬─────────┘
                              │
         ┌────────────────────┼────────────────────┐
         │         │          │          │         │
    ┌────▼────┐ ┌──▼───┐ ┌───▼───┐ ┌────▼────┐ ┌──▼────┐
    │Agent-1  │ │Agent-2│ │Agent-3│ │Agent-4  │ │Agent-N│
    └────┬────┘ └──┬───┘ └───┬───┘ └────┬────┘ └──┬────┘
         │         │         │          │         │
    ┌────▼─────────▼─────────▼──────────▼─────────▼────┐
    │             AWS Bedrock Runtime                   │
    │     (Claude Opus / Sonnet / Llama Maverick)       │
    └──────────────────────────────────────────────────┘

Configuration

Environment variables (or .env file):

AICIPPY_AWS_REGION=us-east-1
AICIPPY_DEFAULT_MODEL=opus
AICIPPY_MAX_PARALLEL_AGENTS=10
AICIPPY_LOG_LEVEL=INFO

Configuration file: ~/.aicippy/config.toml

Security

• Authentication: AWS Cognito with password + OTP (email verification code)
• Token Storage: OS keychain (macOS Keychain, Windows Credential Manager, Linux SecretService)
• Transport: All communications over TLS 1.3
• Tenant Isolation: Multi-tenant data separation with validated namespaces
• Path Traversal Protection: All file paths validated against traversal attacks
• Secrets: Never logged, printed, or stored in plaintext
• IAM: Least privilege roles for all AWS operations

Terminal Compatibility

• UTF-8: Full Unicode symbols with automatic ASCII fallback
• NO_COLOR: Respects the no-color.org standard
• Responsive: Adapts layout to terminal width (full / compact / minimal)
• Accessibility: Works in screen readers and with TERM=dumb

Development

# Install dev dependencies
pip install -e ".[dev]"

# Run linter
ruff check src/

# Format code
ruff format src/

# Type checking
mypy src/aicippy/

Source Code

This is a proprietary project. Source code access requires authorization.

To request read access, visit the GitHub repository and contact the maintainers.

License

Proprietary - AiVibe Software Services Pvt Ltd

Support

• Website: aicippy.com
• Documentation: docs.aicippy.com
• Issues: GitHub Issues (authorized users)
• Email: [e-mail]

---

Created by Lord of AI, Aravind Jayamohan | AiVibe Software Services Pvt Ltd, Chennai, India.