Metadata-Version: 2.4
Name: kashcloud
Version: 0.5.0
Summary: KashCloud CLI -- Deploy and manage AI agents from your terminal
Project-URL: Homepage, https://kashcloud.co
Project-URL: Documentation, https://kashcloud.co/docs
Project-URL: Repository, https://github.com/pacoai-afk/kashagent
Project-URL: Issues, https://github.com/pacoai-afk/kashagent/issues
Project-URL: Changelog, https://kashcloud.co/changelog
Author-email: KashCloud <hello@kashagent.com>
License-Expression: MIT
License-File: LICENSE
Keywords: agents,ai,ai-agents,cli,cloud,deploy,developer-tools,llm,terminal
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.10
Requires-Dist: httpx>=0.28.0
Description-Content-Type: text/markdown

# KashCloud CLI

Deploy and manage AI agents from your terminal. Like Claude Code, but yours.

[![PyPI version](https://badge.fury.io/py/kashcloud.svg)](https://pypi.org/project/kashcloud/)
[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)

## Install

```bash
pip install kashcloud
```

## Quick Start

```bash
# Authenticate
kashcloud login

# Interactive AI terminal (Claude Code-style)
kashcloud

# One-shot message
kashcloud chat "explain this codebase"

# Deploy a persistent AI agent
kashcloud deploy agent.py

# Manage agents
kashcloud list
kashcloud logs <agent_id>
kashcloud stop <agent_id>
kashcloud restart <agent_id>
```

## Interactive Terminal

Running `kashcloud` with no arguments launches an interactive AI terminal powered by Gemini 2.5 Flash (free). It can:

- Read and write files in your project
- Run shell commands
- Explain and refactor code
- Deploy agents to KashCloud

### Terminal Commands

| Command | Description |
|---------|-------------|
| `/help` | Show all commands |
| `/read FILE` | Read a file |
| `/run CMD` | Run a shell command |
| `/deploy FILE` | Deploy an agent |
| `/agents` | List your agents |
| `/clear` | Clear conversation |
| `/exit` | Quit |

Or just type naturally: *"read main.py and explain it"*, *"fix the bug on line 42"*, *"create a REST API for user management"*.

## Agent Deployment

Deploy persistent Python agents that run 24/7 on KashCloud:

```bash
# Basic deploy
kashcloud deploy my_agent.py

# With options
kashcloud deploy my_agent.py --name "price-tracker" --model claude-sonnet --memory 512
```

Agents get:
- Persistent memory
- Automatic restarts
- Log streaming
- Model routing (cheap/mid/premium)

## Configuration

Config is stored at `~/.kashcloud/config.json`. You can also use environment variables:

- `KASHCLOUD_API_KEY` -- Your API key
- `KASHCLOUD_API_URL` -- Custom API endpoint

## Links

- Website: [kashcloud.co](https://kashcloud.co)
- Developer docs: [kashcloud.co/docs](https://kashcloud.co/docs)
- Dashboard: [kashcloud.co/dashboard](https://kashcloud.co/dashboard)

## License

MIT
