Artificial Intelligence Responsive Integrated System

AI-Powered Command-Line Assistant

Name: AIRIS
Author: Umaiz Sufiyan

An intelligent coding agent that lives in your terminal. Built for developers who want AI assistance without leaving the command line.

Install AIRIS Watch Demo GitHub

npm global install

multi-provider AI

airis@terminal

Creator: Umaiz Sufiyan
Version: v0.79.8
License: MIT
Node: >=>=22.19.0

Capabilities

Everything you need in the terminal

AIRIS-CLI combines AI assistance with developer tooling for a seamless command-line workflow.

Interactive terminal UI

AIRIS launches an interactive terminal experience for coding conversations and project work.

Source: README: Interactive TUI; help: `airis` launch command

File operations

Built-in tool names include read, write, edit, grep, find, and ls for project-aware file workflows.

Source: CLI help: Built-in Tool Names

Shell execution

The built-in bash tool executes shell commands, with trust and approval controls around mutation-capable tools.

Source: CLI help: bash tool; Project trust commands

Session management

List, resume, continue, fork, name, store, clear, and export sessions from the CLI.

Source: CLI help: Sessions and session options

Provider selection

Choose providers and models with `--provider`, `--model`, and `--list-models`.

Source: CLI help: AI commands and provider/model options

Verified Autonomy

Mission contracts, capability leases, evidence reports, and failure search are exposed as CLI commands.

Source: CLI help: Verified Autonomy section

Ship workflow

`airis ship` starts, resumes, cancels, lists, and reports status for a full development workflow.

Source: CLI help and docs/airis-ship.md

Project trust

Trust commands and per-run approval flags control project-local resources and mutation tools.

Source: CLI help: Project section

Extensions and skills

AIRIS can load extension files, skills, prompt templates, themes, and package sources.

Source: CLI help: Developer, Config, Tools sections

Theme support

Theme listing, setting, preview, and custom theme file loading are supported.

Source: CLI help: theme commands and `--theme` option

Termux support

The repository includes Android Termux installation instructions for running AIRIS in Termux.

Source: README and docs/installation.md

Machine-readable modes

Use `--mode json` or `--mode rpc` for machine-readable output and process integration.

Source: CLI help: Developer section and Options

Live Demo

See AIRIS CLI in action

Watch the installation process and see how AIRIS works in the terminal.

AIRIS Install Demo

Install Proof

Verified installation inside a real Android Termux environment using npm.

CLI Launch Proof

AIRIS CLI launching interactively with full command recognition and AI provider connectivity.

Terminal Workflow Proof

Complete workflow from install to running AI-powered coding commands in a real terminal.

Installation

Get started in minutes

Node.js >=22.19.0 required. Choose your preferred installation method below.

Quick install

One-line curl install

bash

curl -fsSL https://sufiyan-sabeel.github.io/AIRIS-CLI/install.sh | bash

npm install

Install globally via npm

bash

npm install -g @sufiyan-sabeel/airis-cli

bash

airis --help

Source build

Clone and build from source

bash

git clone https://github.com/sufiyan-sabeel/AIRIS-CLI.git
cd AIRIS-CLI
npm install
npm run build

Termux install

Install on Android via Termux

bash

pkg update
pkg install nodejs git
npm install -g @sufiyan-sabeel/airis-cli
airis --version

Quick start

Start from the terminal you already use.

Set up a provider API key, launch interactive mode, or run one-shot prompts. AIRIS works with multiple AI providers.

Provider key

Use an environment variable like GEMINI_AAIRIS_KEY or OPENAI_AAIRIS_KEY.

CLI modes

Run interactive with airis, or one-shot with airis -p.

bash

export GEMINI_AAIRIS_KEY="your-key"
# or export OPENAI_AAIRIS_KEY="your-key"
# or export ANTHROPIC_AAIRIS_KEY="your-key"

airis
airis -p "List all TypeScript files in src/"
airis --continue

airis ship

Full-lifecycle workflow

The `airis ship` workflow moves from request and contract through testing, verification, proof, and optional commit.

Request

Contract

Approval

Planning

Implementation

Formatting

Testing

Verification

Proof

Commit

Command Reference

Explore AIRIS CLI commands

Search and browse available commands, their descriptions, and usage patterns.

43 commands

airisCore

Launch interactive AIRIS.

Usage: airis [options] [@files...] [messages...]

Example: airis

airis chatCore

Launch chat mode as an alias.

Usage: airis chat

Example: airis chat

airis helpCore

Show help, optionally for a command.

Usage: airis help [command]

Example: airis help

airis versionCore

Show version and brand metadata.

Usage: airis version

Example: airis version

airis changelogCore

Show the latest changelog entry.

Usage: airis changelog

Example: airis changelog

airis -pAI

Run one-shot prompt mode.

Usage: airis -p "prompt"

Example: airis -p "Summarize package.json"

airis --providerAI

Select provider.

Usage: airis --provider <name>

Example: airis --provider anthropic -p "Explain this code"

airis --modelAI

Select model or provider/model.

Usage: airis --model <pattern>

Example: airis --model anthropic/*sonnet*

airis --list-modelsAI

List configured models with optional search.

Usage: airis --list-models [search]

Example: airis --list-models

airis trustProject

Trust current project folder.

Usage: airis trust

Example: airis trust

airis trust listProject

List saved trust decisions.

Usage: airis trust list

Example: airis trust list

airis trust revokeProject

Remove a trust decision.

Usage: airis trust revoke <path>

Example: airis trust revoke .

airis missionVerified Autonomy

Create a scoped mission contract.

Usage: airis mission "<request>" --verified

Example: airis mission "Add tests" --verified

airis mission approveVerified Autonomy

Approve scope and create a temporary lease.

Usage: airis mission approve <id>

Example: airis mission approve mission-123

airis mission runVerified Autonomy

Run evidence-backed verification.

Usage: airis mission run <id>

Example: airis mission run mission-123

airis evidence showVerified Autonomy

Show structured proof-of-completion.

Usage: airis evidence show <mission-id>

Example: airis evidence show mission-123

airis lease listVerified Autonomy

List active capability leases.

Usage: airis lease list

Example: airis lease list

airis failures searchVerified Autonomy

Search failure genome records.

Usage: airis failures search "<error>"

Example: airis failures search "TypeError"

airis ship startShip

Start a full development workflow.

Usage: airis ship start "task"

Example: airis ship start "Add a help command"

airis ship statusShip

Show workflow status.

Usage: airis ship status [id]

Example: airis ship status

airis ship resumeShip

Resume the active workflow.

Usage: airis ship resume

Example: airis ship resume

airis ship cancelShip

Cancel the active workflow.

Usage: airis ship cancel

Example: airis ship cancel

airis ship listShip

List all ship workflows.

Usage: airis ship list

Example: airis ship list

airis session listSessions

List sessions.

Usage: airis session list [--all]

Example: airis session list

airis session resumeSessions

Resume a session.

Usage: airis session resume <id>

Example: airis session resume abc123

airis session currentSessions

Show latest current-project session.

Usage: airis session current

Example: airis session current

airis session clearSessions

Clear current-project sessions.

Usage: airis session clear [--yes]

Example: airis session clear --yes

airis config showConfig

Show sanitized config.

Usage: airis config show

Example: airis config show

airis config getConfig

Read config value.

Usage: airis config get <key>

Example: airis config get theme

airis config setConfig

Write config value.

Usage: airis config set <key> <val>

Example: airis config set theme graphite

airis config pathConfig

Show settings path.

Usage: airis config path

Example: airis config path

airis theme listConfig

List themes.

Usage: airis theme list

Example: airis theme list

airis theme setConfig

Set a theme.

Usage: airis theme set graphite

Example: airis theme set graphite

airis tools listTools

Detect companion CLIs.

Usage: airis tools list

Example: airis tools list

airis tools doctorTools

Diagnose companion tools.

Usage: airis tools doctor

Example: airis tools doctor

airis installTools

Install extension source.

Usage: airis install <source> [-l]

Example: airis install ./local/path

airis removeTools

Remove extension source.

Usage: airis remove <source> [-l]

Example: airis remove npm:@foo/bar

airis listTools

List installed extensions.

Usage: airis list

Example: airis list

airis doctorSystem

Check runtime health.

Usage: airis doctor

Example: airis doctor

airis updateSystem

Update AIRIS and extensions.

Usage: airis update [source|self]

Example: airis update

airis --modeDeveloper

Machine-readable output modes.

Usage: airis --mode json|rpc

Example: airis --mode json -p "Summarize"

airis --extensionDeveloper

Load an extension file.

Usage: airis --extension <path>

Example: airis --extension ./extension.ts

airis --skillDeveloper

Load a skill file or directory.

Usage: airis --skill <path>

Example: airis --skill ./skills

Mobile Development

Android & Termux Ready

AIRIS works seamlessly with Termux workflows. Mobile-first development is a core goal of the project.

Run AIRIS directly on your Android device through Termux — a powerful terminal emulator for Android. No cloud dependency required.

Termux Native

Install and run AIRIS inside Termux with pkg and npm. Full CLI functionality available on mobile.

Linux Home Build

Build from Termux/Linux home directory, not Android shared storage, for best performance.

Android CompatibleTermux OptimizedMobile-First

bash

pkg update
pkg install nodejs git
npm install -g @sufiyan-sabeel/airis-cli
airis --help

After installation, run airis --help to explore available commands.

Available NowWeb + Mobile PWA

AIRIS Web IDE

A full-featured code editor with AI assistance, file explorer, terminal, and project management — running entirely in your browser with PWA support for mobile.

Features Monaco editor, AI chat panel, file tree, integrated terminal, diff viewer, and multi-provider AI support. Installable on Android and iOS via "Add to Home Screen".

Try AIRIS IDE View Roadmap

airis-ide (active)

AI Coding Workflows

Automation Designer

Project Views

Integrated Terminal

Available now — open in your browser

Planned Features

What the IDE will offer

These are aspirational goals for the future AIRIS IDE. Nothing here is implemented yet.

AI-powered code editor with integrated terminal

Project structure viewer and file explorer

Automation workflow designer

Session management and history browser

Extension and skill marketplace

Theme and layout customization

Documentation

Provider environment variables

Variables below are present in `airis --help` output. Set one before launching AIRIS.

Anthropic

ANTHROPIC_AAIRIS_KEY or ANTHROPIC_OAUTH_TOKEN

OpenAI

OPENAI_AAIRIS_KEY

Google Gemini

GEMINI_AAIRIS_KEY

Groq

GROQ_AAIRIS_KEY

Mistral

MISTRAL_AAIRIS_KEY

DeepSeek

DEEPSEEK_AAIRIS_KEY

OpenRouter

OPENROUTER_AAIRIS_KEY

Amazon Bedrock

AWS_PROFILE / AWS credentials / AWS_BEARER_TOKEN_BEDROCK

Azure OpenAI

AZURE_OPENAI_AAIRIS_KEY

Cloudflare

CLOUDFLARE_AAIRIS_KEY and CLOUDFLARE_ACCOUNT_ID

Cerebras

CEREBRAS_AAIRIS_KEY

xAI

XAI_AAIRIS_KEY

Fireworks

FIREWORKS_AAIRIS_KEY

Together AI

TOGETHER_AAIRIS_KEY

Kimi For Coding

KIMI_AAIRIS_KEY

MiniMax

MINIMAX_AAIRIS_KEY

NVIDIA NIM

NVIDIA_AAIRIS_KEY

Ollama (Local)

OLLAMA_AAIRIS_KEY or OLLAMA_BASE_URL (default http://localhost:11434)

Project Journey

Built by a young developer

Created by Umaiz Sufiyan, a student developer and independent builder behind KageOS. He began building AIRIS at 15 and continues developing it at 16 with a focus on AI-powered command-line tools, automation, developer productivity, and mobile-first development.

Started at 15

Umaiz began building AIRIS at age 15, driven by a vision for AI-powered developer tools.

Continuing at 16

Now 16, Umaiz actively maintains and evolves AIRIS with regular releases and new capabilities.

Under KageOS

The project is built under KageOS — focused on CLI tooling, automation, and developer workflows.

Safety & Trust

Built with developer safety in mind

AIRIS runs locally with your user permissions. Trust controls and safety features help you work confidently.

README states AIRIS runs locally with your user permissions and does not sandbox itself.
Project trust controls whether AIRIS can use project-local resources and mutation tools.
Do not paste .env files, private keys, API tokens, or personal data into public issues or prompts.
AI-generated code requires human review according to the repository README.