aicli

<div align="center">

An open-source AI agent that lives in your terminal.

Understands your codebase · Runs commands · Browses the web · Ships code

[](LICENSE) [](https://nodejs.org) [](https://www.typescriptlang.org) [](https://www.npmjs.com/package/aicli) [](https://github.com/HarrisonCN/aicli/actions)

English · 中文 · Docs · Examples

</div>

---

aicli is a lightweight, open-source AI coding agent that runs entirely in your terminal. Inspired by tools like Gemini CLI and Claude Code, aicli gives you a model-agnostic, fully hackable alternative that works with any OpenAI-compatible API.

It uses a ReAct (Reasoning + Acting) loop to autonomously:

• 📂 Read and write files in your project
• 🖥️ Execute shell commands and interpret output
• 🔍 Search across your codebase with regex
• 🌐 Search the web for up-to-date information
• 🐛 Find and fix bugs end-to-end
• ✅ Generate and run tests

$ aicli chat "There's a bug in my auth middleware. Find it and fix it."

⚡ list_directory(path=src/middleware)
⚡ read_file(path=src/middleware/auth.ts)
⚡ search_files(pattern="req.headers.authorization", path=src)

I found the issue. In `auth.ts` line 42, the token is split on " " but the
Bearer prefix check is missing. Here's the fix:

⚡ edit_file(path=src/middleware/auth.ts, old_string=..., new_string=...)

✅ Fixed! The middleware now correctly validates Bearer tokens.

# npm
npm install -g aicl