# 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)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://stakpak.gitbook.io/docs/tutorial/install-stakpak-in-zed-ide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.