git404hub

what is waylou fr?

helis-d/waylou — explained in plain English

Analysis updated 2026-05-18

2TypeScriptAudience · developerComplexity · 3/5LicenseSetup · moderate

tl;dr

A terminal-based AI coding assistant forked from Gemini CLI that lets you bring your own keys and switch between multiple AI providers.

vibe map

mindmap
  root((waylou))
    What it does
      Multi provider AI CLI
      Bring your own key
      Provider orchestration
      Headless automation
    Tech stack
      TypeScript
      Node.js
      Gemini CLI fork
    Use cases
      Terminal coding assistant
      Multi model teams
      CI CD automation
    Audience
      Developers
      AI tool builders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Run an AI coding assistant in the terminal using your own API keys for Gemini, OpenAI, Anthropic, or DeepSeek.

VIBE 2

Set up a team of AI models with different roles, such as architect, coder, and reviewer, that route tasks automatically.

VIBE 3

Run the assistant headlessly inside a CI/CD pipeline to review pull requests or automate coding tasks.

what's the stack?

TypeScriptNode.jsCLIGemini CLI

how it stacks up fr

helis-d/waylouadun-denton/chinvatagbara286/saint-cms
Stars222
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatemoderateeasy
Complexity3/54/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Requires Node.js 20+ and an API key from at least one supported provider, or Ollama installed locally for offline models.

Use freely for any purpose, including commercial use, as long as you keep the copyright and license notice.

in plain english

Waylou is an open source AI coding assistant that runs in your terminal, forked from Google's Gemini CLI. Where the original only connects to Gemini, Waylou lets you plug in several different AI providers through one interface, including Gemini, OpenAI, Anthropic, Ollama for local models, and DeepSeek. You bring your own API keys for whichever providers you want to use, and you can even switch models mid session. One of its bigger features is provider orchestration, which lets you set up a team of models with different roles, such as one acting as architect, one as coder, and one as reviewer, with tasks distributed between them using strategies like picking the best model for the job, round robin, or having several models vote. It also defines something called the ACE specification, short for Agentic Coding Environment, which standardizes how an AI agent is allowed to behave at three levels: basic file and shell operations, standard features like memory and sandboxing, and enterprise features like policy enforcement and audit logging. Waylou can run interactively in your terminal or headlessly, meaning it can be scripted into CI/CD pipelines and automated workflows without a human typing into it. For finding relevant code, it uses a context engine that combines vector embeddings with AST based code analysis. For safety, it can execute commands inside a sandbox using macOS Seatbelt, Docker, or Podman. Installing it requires Node.js 20 or newer and npm 9 or newer, and you can install it globally with npm or run it directly with npx. The project describes itself as under active development, with core functionality working but the provider layer still being built out, and the maintainers say that layer is where they most want help from contributors. It is released under the Apache License 2.0.

prompts (copy fr)

prompt 1
Install waylou globally and configure it to use my Anthropic API key.
prompt 2
Explain the difference between the CORE, STANDARD, and ENTERPRISE levels of waylou's ACE specification.
prompt 3
Show me how to run waylou in headless mode to review a pull request.
prompt 4
Help me set up a local model with waylou using Ollama.

Frequently asked questions

what is waylou fr?

A terminal-based AI coding assistant forked from Gemini CLI that lets you bring your own keys and switch between multiple AI providers.

What language is waylou written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, CLI.

What license does waylou use?

Use freely for any purpose, including commercial use, as long as you keep the copyright and license notice.

How hard is waylou to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is waylou for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.