Webbee 🐝 — The Open-Source ICNLI Coding Agent
Webbee is the free, open-source terminal coding agent of Imperal Cloud (the ICNLI AI Cloud OS). It acts directly in your local terminal and workspace: reading, writing, editing, refactoring, and verifying code with deep code intelligence, native multimodal vision, and live cross-platform system capabilities.
Webbee is powered by ICNLI (Infrastructure Contextual Natural Language Interface — icnli.org), the open protocol that maps natural-language intent to context-aware infrastructure actions.
Open-Source Guarantee (GPLv3): Webbee belongs to the community. No locked silos, no hidden telemetry, no arbitrary execution barriers. The model proposes; the kernel evaluates; you hold the key.
🚀 Key Features
- 🧠 Real Agentic AI Brain, Not a Chatbot: Reasons across your entire workspace, plans multi-step tasks, reads project architecture, executes terminal commands, and edits code safely.
- 👁️ Native Multimodal Vision (
view_image): Direct image inspection (UI mocks, diagrams, screenshots, graphs) for vision-capable models, with automatic graceful fallback to OCR and document extraction via File Reader. - 🌐 Integrated Web Search (
web_search&read_url): Perform live web research and retrieve documentation directly in your terminal sessions via Imperal's system web-search extension — zero local API keys required. - 🛡️ Ironclad Safety & Reversibility: Built-in Shadow Git time-machine snapshots every workspace modification (
checkpoint,diff,rollback). Revert any step instantly. - 🔌 Platform & Extension Arsenal: Seamless access to connected cloud extensions (Mail, Vikunja Tasks, Notes, Google Analytics, GitHub, Proxmox, Stripe, SSH Connections, and more).
- ⚡ Lightning Fast & Memory-Efficient: Instant startup with granular lazy imports, configurable RAM limits (256MB to 8GB) with LRU eviction, and fail-soft permission handling.
- 🖥️ First-Class Cross-Platform TUI: Beautiful, responsive terminal interface compatible with macOS (Terminal.app, iTerm2), Linux (Alacritty, Kitty, WezTerm), and Windows Terminal. Normalized 2-cell icon widths for pixel-perfect alignment.
📦 Installation
One line — installs uv if needed, which brings its own Python:
curl -LsSf https://raw.githubusercontent.com/imperalcloud/webbee-code/main/install.sh | sh
Or, if you already have uv or pipx:
uv tool install webbee
# or:
pipx install webbee
Webbee needs Python 3.10 or newer. uv fetches a suitable Python by itself, so it works even where
the system Python is older (macOS ships 3.9).
Install problems
| You see | Why | Do |
|---|---|---|
Cannot install webbee==… because these package versions have conflicting dependencies / ResolutionImpossible |
pip/pipx runs on a Python older than 3.10 (or webbee < 0.5.5 on Python 3.10) | uv tool install webbee, or pipx install --python python3.12 webbee |
No matching distribution found for webbee |
Python older than 3.10 | same as above |
error: externally-managed-environment |
pip install into the system Python is blocked on Homebrew, Debian 12+, Ubuntu 23.04+ |
uv tool install webbee or pipx install webbee |
webbee: command not found after install |
the tool folder is not on PATH |
uv tool update-shell (or pipx ensurepath), then open a new terminal |
💡 Quick Start
# Start Webbee in your project workspace
webbee
# Sign in to link your Imperal Cloud account (RFC 8628 device flow)
webbee login
Inside the interactive terminal:
- Speak naturally in English, Ukrainian, or any language you prefer.
- Type
/helpto see all available slash-commands (/login,/mode,/status,/cost,/clear,/exit). - Use Shift + TAB to cycle execution modes:
- default: Asks confirmation for major changes or destructive operations.
- plan: Formulates an exhaustive execution strategy before touching any code.
- autopilot: Autonomous mode for rapid prototyping and uninterrupted development runs.
🛠️ Built-in Terminal Toolset
| Icon | Tool | Description |
|---|---|---|
| 📖 | read_file |
Read text and source files byte-exact, with offset/limit paging |
| ✏️ | write_file |
Create or overwrite files atomically with snapshot tracking |
| 🔧 | edit_file / multi_edit |
Precise find-and-replace edits across one or multiple files |
| ⚡ | shell |
Execute shell/terminal commands across Windows, macOS and Linux with streaming |
| 🔎 | grep / glob |
Fast regex code search and workspace file pattern matching |
| 🌐 | web_search / read_url |
Search the web and read web documentation in clean Markdown |
| 🖼️ | view_image |
Inspect images with native multimodal vision + OCR fallback |
| 🗂️ | diff / rollback |
Inspect recent changes and roll back to previous checkpoints |
📜 License
Webbee is free and open-source software licensed under the GNU General Public License v3.0 (GPL-3.0-or-later). See the LICENSE file for details.
Developed with 🐝 by the Imperal Cloud team.
1 maintainer
Metadata
1 maintainer
Release files for webbee 0.5.5
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| webbee-0.5.5.tar.gz | 508.9 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| webbee-0.5.5-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 802.8 kB
Release files / webbee-0.5.5.tar.gz
| Download URL | webbee-0.5.5.tar.gz |
|---|---|
| Size | 508.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
497349d941f30aeb69c121b060c0e3ae69cf25016662845492ccd4c9ba798079
|
|
BLAKE2b-256 checksum How to use checksums |
706ce18a091d7bc1754a67d1d11f2afda9bb092f657ff7c0c1ce897806efecd6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Release files / webbee-0.5.5-py3-none-any.whl
| Download URL | webbee-0.5.5-py3-none-any.whl |
|---|---|
| Size | 293.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
26a8e4a08a1d00c570772713dfc768afb61455cfd70f70f623e04b01410fc2de
|
|
BLAKE2b-256 checksum How to use checksums |
f6a50de17041334e4771970d82ff817c8a2d2049a2cecfe882f5937c20506445
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Security for webbee 0.5.5
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
