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
Install easily using pipx (recommended) or uv:
pipx install webbee
# or with uv:
uv tool install webbee
Or install in a Python virtual environment:
python3 -m venv .venv && source .venv/bin/activate
pip install webbee
💡 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.4.4
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.4.4.tar.gz | 487.5 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| webbee-0.4.4-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 770.6 kB
Release files / webbee-0.4.4.tar.gz
| Download URL | webbee-0.4.4.tar.gz |
|---|---|
| Size | 487.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
bcdd628bfa4c14fd1ec853f8a64d86ec78ee8e7fcd22ccc094ac8dc7a75ffbc2
|
|
BLAKE2b-256 checksum How to use checksums |
a9c38738a24843e439e198242dc69540eff9754730e245d9bd94174418b894d4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / webbee-0.4.4-py3-none-any.whl
| Download URL | webbee-0.4.4-py3-none-any.whl |
|---|---|
| Size | 283.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
4c030f03fc2f9aae681effc094f8483d23333d1c8c105873f001f55d9cc05a07
|
|
BLAKE2b-256 checksum How to use checksums |
87e29d5df322967de9807d09182178d2fdedf1be99e62d9909f62c829105cf55
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Security for webbee 0.4.4
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.
