You and your team
Integrations
Connect GitHub and Slack, share a running app with a Live Link, and share a read-only copy of a task.
GitHub
Your GitHub account can be how you sign in, and the GitHub CLI (gh) on your computer is how Zokie shows pull requests and checks and merges them.
Connect the GitHub CLI
- Open Settings › Connections and find the GitHub CLI card under Code.
- If the CLI is missing, press Install and run the command it shows, such as
brew install gh(on Windows,winget install --id GitHub.cli). - Press Sign in and run the command it shows, such as
gh auth login --hostname github.com --web. - Press Check status. The card shows the signed-in account.
Until the CLI is installed and signed in, pull requests and checks stay empty.
Pull requests, checks and merge
Agents open pull requests as they work, or press Open PR on a repository that has none. The bar above the chat lists each pull request with its state: Draft · not ready to merge, Checks running, checks failed (with Ask Dev to fix), Has conflicts, Ready to merge, Merged or Closed without merging. The Checks tab lists every status check, including GitHub Actions, with its outcome, run time and a link.
Merge turns on once a pull request is ready. Zokie shows the target branch and check counts, then you confirm with Merge PR #n. Zokie squash-merges into the default branch. It never merges on its own: only when you confirm, or ask from your phone or Slack. Your guardrails can block a merge. See Review and ship.
Slack
Start a task from Slack and follow it in one thread. The agent still runs in Zokie on your computer, so keep Zokie open and signed in. Needs Pro or a paid Teams seat; see Pricing.
Connect Slack
- Open Settings › Connections › Slack and press Add to Slack. Pick your workspace and press Allow. Some workspaces need an admin to approve the app.
- In Slack, type
/zokie linkand open the link it gives you while signed in to Zokie. It works once. - The Slack card reads Linked.
Tasks from Slack run on picks their model: This Mac's default, Auto select (paid plans) or a model and effort. To disconnect, press Disconnect on the card.
Start and steer a task
/zokie new Fix the login redirect(or/zokie Fix the login redirect) starts a task now; its thread follows it.- Send Zokie a direct message with what to build.
- Reply under a bug report with
@Zokie fix this issue please; recent thread messages go along as context. /zokie task Update the READMEsaves a task to Today without running it.
Invite Zokie to a channel first with /invite @Zokie. Only the person who started a task can steer it; Zokie acts only on messages that mention it.
| In the thread | Does |
|---|---|
@Zokie and your message | Sends the agent your next instruction. |
@Zokie status | Shows state, current step and pull request. |
@Zokie allow / @Zokie deny | Answers a permission request. |
@Zokie start / @Zokie stop | Starts a saved task or stops the agent. |
@Zokie merge | Merges the task's pull request. |
/zokie status lists your last five tasks from Slack, and /zokie help lists the commands. Slack never shows what a task costs, and your code stays on your computer.
Live Links
A Live Link is a short zok.ie link to a dev server on your computer, so you can open it on your phone or send it to a teammate while it runs. Needs a paid plan; see Plans.
When an agent or your terminal shows a localhost address and a server answers there, it reads zok.ie/k7m2pq with a chip beside it. Click the link to open it here; copy it to share. In the terminal, ⌘-click a localhost address to copy its Live Link. Windows uses Ctrl in place of ⌘.
The chip's dot is green when live, amber while starting and grey when offline. Click the chip to copy the link, change Who can open it, Stop sharing until the server restarts, or open Live Link settings.
| Access | Who |
|---|---|
| Only me | Only you, signed in. The default. |
| Team | Everyone on this board's team, signed in. Team boards only. |
| Public | Anyone with the link. Zokie lists the risks and asks you to confirm. |
If the server restarts soon after stopping, it keeps the same link. In Settings › Workspace › Live Links, turn Replace localhost with Live Links on or off, set what New links open for, and see Your Live Links.
Sharing a task
Share on a task's page gives it a read-only link on zokie.dev, such as zokie.dev/@name/k7m2pq4x9a. Under General access pick Only me (default, no link works), Team (team boards only, signed in) or Public (anyone, after you confirm with Make public). Switching back to Only me turns the link off at once.
Pick a username first: yours for your personal board (Pick a username opens your profile), or the team's for a team board (Team settings). Copy app link copies a link that opens the task in Zokie.
People see the title, notes, project, priority, labels, column, plan section and whether it's archived. Never the chat, files, branches, pull requests, assignees or emails. Old links keep working after a username change.