EstaCoda

العربية

Open-source runtime for Agent Evolution — the first of its kind built in the Arab world.

EstaCoda is a terminal-native AI agent that gets better from real work. It uses tools, remembers across sessions, runs through messaging channels, schedules recurring jobs, and turns repeated execution patterns into reusable skills and workflows.

Bring your own model. Run it locally, on a server, through Docker, or from WSL2. Use it from the terminal, Telegram, and gated WhatsApp. Discord and Email adapters are present for operators who validate them in their own deployment.

EstaCoda is built with Arabic as a first-class operating language, including shaped, bidirectional Arabic rendering for terminal workflows.

When EstaCoda proposes changes to its own harness, they stay reviewable: evidence, hypothesis, approval, and rollback — not silent mutation.

Built by SIFR01.

Why EstaCoda

The Agent Evolution Loop

1. Give EstaCoda real work.
2. It uses tools, memory, skills, browser automation, shell commands, scheduled jobs, and channel delivery as needed.
3. When a useful pattern repeats, it can propose a reusable skill, workflow, or harness improvement.
4. You review the evidence, approve the change, revise it, or reject it.
5. Future sessions start with more useful context and reusable capability than the last one.

Example Uses

"Every morning, check my orders, supplier emails, and delivery issues. Send me a Telegram summary in Arabic with anything that needs action."

"Monitor customer messages from Telegram and email, group them by issue, and draft replies in Arabic and English."

"Compare payment gateways for an online store selling across Egypt, Saudi Arabia, and the UAE. Check pricing, settlement times, local support, and integration effort."

"Watch competitor websites and social pages across the GCC, Egypt, and Jordan. Summarize new products, pricing changes, and campaigns every Sunday."

"Track this GitHub repo and tell me what changed before our weekly release meeting. Turn the release checklist into a reusable workflow."

"Research packaging suppliers in Cairo, Riyadh, Casablanca, and Dubai. Compare minimum order quantities, lead times, and estimated cost."

"Prepare a weekly sales follow-up list from my email threads. Separate hot leads, blocked deals, and people who need a reminder."

"Watch property listings in Riyadh, Cairo, Amman, and Dubai. Alert me when prices change or a comparable unit appears."

"Track tenders and procurement announcements in my sector. Summarize relevant opportunities and deadlines each week."

"Research cafés, clinics, or boutiques launching new branches in my city. Build a short partnership or sales prospect list."

Quick Install

macOS, Linux, WSL2, and Termux:

curl -fsSL https://www.estacoda.com/install.sh | bash

The installer creates a managed-source install, symlinks a wrapper to ~/.local/bin/estacoda, and adds PATH to your shell rc if needed. After installation, reload your shell or open a new terminal.

For the full setup flow, see the Quickstart.

First Run

estacoda init    # create the default profile and state directories
estacoda setup   # configure provider, model, security mode, and optional channels
estacoda         # start an interactive session

estacoda setup walks through provider selection, endpoint or credential setup where needed, security mode, and optional capabilities. It shows the proposed configuration before anything is written.

Common Commands

estacoda                       # start a terminal session
estacoda init                  # initialize profile and state directories
estacoda setup                 # run the interactive setup wizard
estacoda update                # update using the current install method
estacoda update --check        # check for updates without modifying files
estacoda uninstall             # remove install code and wrappers; keep user data
estacoda uninstall --purge     # remove install code and user data
estacoda whatsapp              # start the WhatsApp setup wizard

For the full command surface, see CLI Commands.

Capability and Maturity

EstaCoda distinguishes between live-proven, configurable, experimental, and emerging functionality. The root README gives the short version; the docs contain the full setup and troubleshooting details.

LLM Providers

Use the built-in local provider for Ollama, LM Studio, llama.cpp, vLLM, or another OpenAI-compatible local/custom endpoint. Custom OpenAI-compatible providers remain available when you need a separate named provider ID with an explicit baseUrl. Catalog-known providers are not automatically runnable; check the provider reference before treating one as a primary route.

Channels

WhatsApp uses an isolated Baileys bridge under scripts/whatsapp-bridge/. The bridge dependencies are managed separately and are not part of the root pnpm workspace. See the channel docs for setup, authorization, pairing, and delivery behavior.

Other Capabilities

Supported Platforms

Requirements

Core requirements

• Node.js >= 22.18.0
• pnpm via Corepack or equivalent
• Git
• POSIX shell

Optional by install path or feature

• Docker for container usage
• Homebrew for the Homebrew install path
• ffmpeg for some media and voice delivery flows

State and Profiles

EstaCoda stores user state under ~/.estacoda/.

The active profile is selected in:

~/.estacoda/active-profile.json

Profiles own their configuration, credentials, memory, gateway state, and logs.

See State and Files for the full state model.

Safety Boundaries

EstaCoda is designed for powerful agent workflows, but it keeps high-impact changes explicit.

• Setup shows the proposed configuration before writing it.
• Hard safety blocks remain active in all security modes.
• open mode is not “security off.”
• Updates mutate only install locations owned by the selected install method.
• Managed installs require installer ownership stamps before removing install code.
• User data is preserved by default during uninstall.
• Harness improvements require reviewable proposals rather than silent self-mutation.

See Security and Approvals for the full model.

Documentation

All documentation lives at www.estacoda.com/docs.

Contributor Install

git clone https://github.com/sifr01-labs/EstaCoda.git
cd EstaCoda
./scripts/setup-estacoda.sh

The setup script installs dependencies, builds the project, and offers to symlink a local wrapper. This creates a manual-source install.

After setup:

estacoda init
estacoda setup
estacoda

Before opening a pull request, run the project validation commands documented in CONTRIBUTING.md.

Updating

estacoda update

Update behavior follows the install method:

Useful flags:

estacoda update --check    # report availability without modifying files
estacoda update --yes      # apply without interactive confirmation where safe
estacoda update --gateway  # run in non-interactive service mode

Startup update checks are enabled by default. They run as non-blocking background prefetches in interactive CLI sessions, use a six-hour cache, and fail silently on network errors.

See Updating for the full update surface.

Uninstalling

estacoda uninstall               # remove install code and wrappers; keep user data
estacoda uninstall --purge --yes  # also remove user data

Default uninstall preserves ~/.estacoda.

Managed-source directories are removed only when a valid installer stamp proves ownership. Manual-source checkouts are preserved. Package-manager and container installs are routed to their respective tools rather than self-mutated.

See Uninstall for method-specific behavior and ownership rules.

Contributing

See CONTRIBUTING.md for development setup, branch workflow, validation commands, and contribution rules.

See AGENTS.md for guidance when using AI coding assistants with this codebase.

See SECURITY.md for the security model, vulnerability reporting process, and supported versions.

License

Apache License 2.0 — see LICENSE.