> For the complete documentation index, see [llms.txt](https://stakpak.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://stakpak.gitbook.io/docs/tutorial/install-stakpak-in-zed-ide.md).

# Install Stakpak in Zed IDE

## Introduction

**What is Zed?**

Zed is a next generation code editor designed for high-performance collaboration with humans and AI.

**What is Stakpak?**

Stakpak is the Open-source DevOps agent that helps you with securing, deploying, and maintaining production-ready infrastructure. ([Introduction](/docs/get-started/introduction.md))

## Installation

### Method 1: Installing the Extension

1. [Install Stakpak](/docs/get-started/install-stakpak.md)
2. [Install Zed](https://zed.dev/)
3. Open Zed and Sign In
4. Go to Zed > Extensions

<figure><img src="/files/rwhEoge56UKTHdzPoHaV" alt=""><figcaption></figcaption></figure>

5. Search for "Stakpak" then press "Install"

<figure><img src="/files/HG1bUeX8JwHXZHX7aWav" alt=""><figcaption></figcaption></figure>

6. To Use Stakpak in Zed
   1. Click Assistant (✨) → `+` → `New stakpak thread`

<figure><img src="/files/U2epLYlvqkDwrjivb5DL" alt=""><figcaption></figcaption></figure>

### Method 2: Manually

1. [Install Stakpak](/docs/get-started/install-stakpak.md)
2. [Install Zed](https://zed.dev/)
3. Open Zed and Sign In
4. Go to Zed > Settings > Open Settings File

<figure><img src="/files/92PJvjnrt3NdKKmYFDam" alt=""><figcaption></figcaption></figure>

5. Then add this and press save (command s)👇🏻

<pre><code><strong>,
</strong><strong>"agent_servers": {
</strong>    "Stakpak": {
      "command": "stakpak",
      "args": ["acp"],
      "env": {}
    }
  }
</code></pre>

<figure><img src="/files/2cOFlsgIqRmVyeRB0T4b" alt=""><figcaption></figcaption></figure>

6. To Use Stakpak in Zed
   1. Click Assistant (✨) → `+` → `New stakpak thread`

<figure><img src="/files/U2epLYlvqkDwrjivb5DL" alt=""><figcaption></figcaption></figure>

## Troubleshooting

### Agent not connecting

1. Verify your API key is set correctly:

   ```
   echo $STAKPAK_API_KEY
   ```
2. Make sure Zed was started from a terminal with the environment variable set
3. Check Zed logs for any error messages

### Binary download issues

If the extension fails to download the binary, you can manually install Stakpak:

```
# macOS (ARM64)
curl -LO https://github.com/stakpak/agent/releases/download/v0.2.66/stakpak-darwin-aarch64.tar.gz
tar -xzf stakpak-darwin-aarch64.tar.gz
sudo mv stakpak /usr/local/bin/

# Verify installation
stakpak --version
```

Then configure Zed to use the system-installed binary (see Zed extension settings).

## Support

For issues, questions, or feature requests:

* Extension issues: [stakpak-zed-extension issues](https://github.com/stakpak/stakpak-zed-extension/issues)
* Stakpak agent issues: [agent issues](https://github.com/stakpak/agent/issues)
* Customer Support: [Discrod](https://discord.gg/c4HUkDD45d)