CLI Quickstart

From install to deployed agent in four commands.

askdao is the command-line tool that connects your local project to the AskDAO platform. It's open source and runs entirely on your machine.

Source: github.com/askdao/askdao-cli

Step 1 — Install

macOS / Linux / WSL

curl -fsSL https://askdao.ai/install.sh | sh

Windows PowerShell

irm https://askdao.ai/install.ps1 | iex

To update later: askdao update

Step 2 — Login

askdao auth login

Opens a browser for OAuth login. Your credentials are saved locally at ~/.config/askdao/credentials.json. MCP tools are automatically configured for Claude Code on your machine.

If you prefer terminal-only: askdao auth login --no-browser

Step 3 — Edit your agent

cd your-project
askdao agent edit

This scans your project and opens a browser wizard with four steps:

  1. Identity — name, description, category, theme color
  2. Persona — model choice, system prompt
  3. Skills & Tools — select skills and MCP tools to include
  4. Review — confirm and save

The wizard saves askdao-agent.yml in your project root. This is the only file you need to commit. Everything else is local scaffolding.

What gets scanned? Package names and dependency counts — not your source code. .env files are never read (only .env.example key names are checked). Nothing sensitive leaves your machine.

Step 4 — Deploy

askdao agent deploy

Returns a link like https://askdao.ai/k/<you>/g/<group_id>. Share it with your community. Redeploying the same project updates in place.

Other commands

CommandWhat it does
askdao auth statusShow current login
askdao auth logoutRemove local credentials
askdao mcp setupRe-configure MCP tools for Claude Code
askdao agent edit --no-uiWrite draft without opening browser (CI use)
askdao agent deploy --forceForce redeploy even if no changes detected
askdao versionPrint CLI version
askdao updateSelf-upgrade