---
# System prepended metadata

title: Local `desktop-agent` and `web5-js` Dev

---

# Local `desktop-agent` and `web5-js` Dev

## Web5 JS
```shell
git clone https://github.com/TBD54566975/web5-js.git
cd web5-js/
git switch refactor-app-dids
npm install
npm run build
npm link
cd examples/test-dashboard
npm install
npm run serve
```

## Desktop Agent
```shell
git clone https://github.com/tbdeng/desktop-agent.git
cd desktop-agent/
git switch refactor-app-dids
npm install
npm link @tbd54566975/web5
npm run dev
```

## Usage

1. When the Desktop Agent launches, click **Start Fresh** to create DIDs.
2. Open Chrome and http://localhost:8080/desktop-agent.html
3. Check your Browser local storage and delete existing `web5-dids` key, if any
4. Click **Basic Permissions** to connect and request 4 permissions
5. You should get a pop up in the Electron app asking you for the security code



Troubleshooting
- Check `Computer\HKEY_CLASSES_ROOT\web5`
- should have: `Computer\HKEY_CLASSES_ROOT\web5\shell\open\command`
    Default `REG_SZ` value of:
    `"C:\Users\Frank\Code\desktop-agent-new\desktop-agent\node_modules\electron\dist\electron.exe" "C:\Users\Frank\Code\desktop-agent-new\desktop-agent" "%1"`
