---
license: mit
language:
- en
---
# AGI CLI

```text
 █████╗  ██████╗ ██╗    ██████╗██╗     ██╗
██╔══██╗██╔════╝ ██║   ██╔════╝██║     ██║
███████║██║  ███╗██║   ██║     ██║     ██║
██╔══██║██║   ██║██║   ██║     ██║     ██║
██║  ██║╚██████╔╝██║   ╚██████╗███████╗██║
╚═╝  ╚═╝ ╚═════╝ ╚═╝    ╚═════╝╚══════╝╚═╝
```

Welcome to **AGI CLI**, an advanced command-line interface developed by AG Corp. This tool provides a powerful environment for interacting with AI agents, managing projects, and more.

## Features

- ✦ **AGI Agent**: Launch an autonomous agent that can think, use tools, and complete complex tasks.
- ✦ **Multiple Model Support**: Support for both **Gemini** and **Poe (claude-haiku-4.5)**.
- ✦ **AI Assistant**: Quick access to powered AI assistant for general queries.
- ✦ **Project Management**: Tools to initialize and manage your coding projects.
- ✦ **Enhanced CLI**: Beautiful colored output and structured UI elements.

## Getting Started

### Prerequisites

- Python 3.x
- A Gemini API Key (you will be prompted to enter this upon first use or when using AI features).
- Or a Poe API Key (you will be prompted to enter this upon first use or when using AI features).

### Installation

1. Clone this repository or download the source code.
2. Navigate to the project directory.

### Running the CLI

To start the AGI CLI, run:

```bash
python3 main.py
```

## Available Commands

Once inside the CLI, you can use the following commands:

- `agi`: Launch the AGI Agent for autonomous task execution.
- `ai`: Talk directly to the AI assistant.
- `project`: Create a new project structure.
- `settings`: Choose between Gemini and Poe models and manage API keys.
- `help`: Display the list of available commands.
- `echo [message]`: Echo back a message in the CLI.
- `exit`: Safely exit the application.

## Project Structure

- `agicli/`: Core package containing all logic.
  - `agi.py`: AGI Agent implementation.
  - `ai.py`: Gemini AI interface.
  - `welcome.py`: Initialization and user setup.
  - `printplus.py`: Enhanced printing and ASCII art engine.
  - `sandbox/`: Secure area for agent-generated files.
  - `user/`: Secure Local storage for user settings and API keys.

## License

MIT 

Created by AG Corp.