Skip to content

README.md

Latest commit

 

History

History
142 lines (87 loc) · 4.85 KB

README.md

File metadata and controls

142 lines (87 loc) · 4.85 KB

AIStack CLI

AIStack CLI is an experimental swiss-knife command-line application designed to streamline the installation and management of AI development tools, including gemini-cli, opencode, asm, 'kilo code', 'orla' and various MCP servers, plugin, extensions, skills, frameworks like bmad-method cli or ADK, and so on. The main goal is to provide a convenient way to install and configure AI tools, ensuring no host impact nor change, to test and use them.

Key Features of AIStack

  • AI Tool Management: Streamlines the installation and configuration of AI agents like gemini-cli, opencode, asm, Kilo Code and so on. Provides some minimal convenient default settings.
  • MCP Server Integration: Easily configure and manage connections to various MCP (Model Context Protocol) servers.
  • Isolated Environments: All tools are installed into a local workspace/ directory, preventing system-wide conflicts. Installing any agent or MCP server will not pollute in anyway your system nor your development environment path with its own dependencies (nodejs, python, ...). Everything is contained in an easy deletable internal folder.
  • Portability: Bash application, works on Linux & MacOS.

Getting Started

Requirements

  • bash
  • git

Commands

aistack provides a simple command-line interface to manage your tools and environments.

To see complete commands use aistack help.

Command Description
init Install/Reinstall dependencies
uninstall Remove any tools and dependencies managed by AIStack
help Display help message
info Display various AIStack information and configuration
shell Enter a sub-shell with the aistack environment and paths configured

How-To

Install and configure gemini-cli from scratch

git clone https://github.com/StudioEtrange/aistack
cd aistack
./aistack init
./aistack gc install
./aistack gc register bash

Register local MCP server calculator

cd aistack
./aistack mcp calculator install

Configure the underlying nodejs to add a local npm registry

cd aistack
./aistack npm config set registry https://registry.local.org/ -g

Directory Structure

  • aistack : Main script.
  • README.md : Documentation main entrypoint.
  • doc/: Various doc topic.
  • lib/: internal libraries and code.
  • pool/: Contains configuration files templates and framework.
  • workspace/: The directory where all isolated environments, dependencies and tools are located.

Integrations

  • AIStack CLI offers functionality for these tools

Gemini CLI

See Gemini CLI

Opencode

See Opencode

CLIProxyAPI

See CLIProxyAPI

asm - agent skill manager

See asm

Kilo Code

See Kilo Code

Orla

See Orla

BMAD

See BMAD

Agent Development Kit (ADK)

See VS Code

VS Code

See VS Code

MCP Servers

AIStack simplifies connecting to MCP (Model Context Protocol) servers, allowing your AI agents to interact with external tools and services.

Supported MCP Servers:

  • Desktop Commander: Grants terminal control and file system access. (Source)
  • Calculator: A simple server for performing calculations. (Source)
  • Context7: Fetches up-to-date documentation and code examples. (Source). https://context7.com/
  • GitHub: Official server for interacting with GitHub issues, PRs, and repositories. (Source)
  • Data Commons: Tools and agents for interacting with the Data Commons Knowledge Graph using the Model Context Protocol (MCP). (Source)

Design Notes

Notes on underlying framework: Stella

AIStack leverages the Stella framework for its core functionality. Stella provides the infrastructure for application structure, environment isolation, and package management.

About Package Management: Stella uses a concept of "Features" (software packages) which are defined by "Recipes" (Bash scripts). aistack uses this system to provide all the tools it manages or use. Stella features recipes are located in pool/stella/nix/pool/feature-recipe/.

Contributors

See the CONTRIBUTORS file for the full list of contributors

License

Licensed under the Apache License, Version 2.0.

Copyright © 2025-2026 Sylvain Boucault.

See the LICENSE file for details.