commit	7265ecf0ccbf8d652b6f9ad3836cb62836d1dbe5	[log] [tgz]
author	iomodo <iomodo@v1.dodo.cloud>	Thu Jul 31 19:52:33 2025 +0400
committer	iomodo <iomodo@v1.dodo.cloud>	Thu Jul 31 19:52:33 2025 +0400
tree	d6ecda9f3f02d319d527052d9b91eaf743572aca
parent	907b43d719e19e80a47538ba3b6b87b6a2657770 [diff]

tree: d6ecda9f3f02d319d527052d9b91eaf743572aca

README.md

Staff

AI multi-agent system simulating startup organization. Agents process tasks, create PRs, auto-complete via webhooks.

Setup

Requirements

Go 1.21+
GitHub token with repo admin permissions

Install

git clone https://github.com/your-org/staff
cd staff

Configure

Edit server/config.yaml:

server:
  listen_address: ":9325"

github:
  token: "your_github_token"
  owner: "your_username"
  repo: "your_repo"

openai:
  api_key: "your_openai_key"

Or use environment variables:

export GITHUB_TOKEN="your_token"
export OPENAI_API_KEY="your_key"

GitHub Webhook Setup

cd server
./staff webhook configure --webhook-url https://yourserver.com/api/v1/proposal/approve

You will need ngrok if you are doing this locally.

Run

cd server
go run cmd/main.go server

Workflow

Agent processes task → creates PR
Human reviews/merges PR
GitHub webhook → task completed
Agent picks up next task

Commands

Commands for convenience no need to use them.

go run cmd/main.go  create-task --title "Task" --description "Details"
go run cmd/main.go  list-tasks
go run cmd/main.go  list-agents
go run cmd/main.go  start-agent --name agent-name
go run cmd/main.go  webhook configure