Skip to main content
Hum works from Slack the way it works at the terminal: it runs the task in its own sandbox, keeps a checklist, asks when a decision is yours, and pushes branches and pull requests to the repository. In a channel it acts for the channel: anyone there can hand it work and steer it, and nobody signs in.

​
Install

A Slack workspace admin clicks Add to Slack at metaphi.ai/hum and approves the permissions. Slack returns to a page that says the workspace is in and shows the two steps left. No Hum account is needed to install.

​
Invite it to a channel

In the channel your team works in:
Hum reads only the channels it is invited to, and in them only the threads it speaks in and the messages that mention it.

​
Connect the repository

A channel works on one repository. From the page Slack returned you to, or from the link Hum answers a first mention with, open Connect a repository: pick the channel, paste the repository URL, and connect. For a private repository there is one step more, on GitHub: an owner of the organisation installs the Hum GitHub App on it, one click on the link the page shows. Sessions then clone, commit and open pull requests as Hum.

​
The first task

Mention it with the task in the channel:
Hum answers in a thread under your message: a line saying the session started, then its plan as a checklist it edits in place as steps complete, then its words as it works. When it needs you, it asks in the thread; reply there. When it finishes, the thread says so, and a later reply there resumes the same session where it left off.

​
Threads and replies

  • A thread is a session. Reply in it to steer, answer or redirect; you need not mention Hum again.
  • Anyone in the channel can reply, member or guest. The words reach the model as written; who said them is on the record.
  • A new mention at the channel’s top level is a new session in a new thread, on the same repository.
  • The session runs in the cloud, on a workspace kept for that channel and repository, so a reply after the sandbox has gone rebuilds it and the work continues.

​
Direct messages

A direct message to Hum is personal work on your own account, not the channel’s. The first time, Hum answers with a sign-in link; sign in once with the email of your Hum account (or the Google or GitHub login you use for it), and from then on your DMs start sessions for you. If your Slack profile email is already a Hum account, nothing is asked. An admin can turn DMs off for the deployment.

​
For admins

  • Channels a repository posts in. A repository names the channels its sessions may post in, in .hum/comms.json.
  • Limits. Usage is counted per organization. No limit is set by default; an admin may set a monthly limit and an alert, and work over the limit is declined with a sentence that says whom to ask.
  • Removing the app. Uninstall it from Slack’s app settings, or revoke its token: the workspace’s token, people, codes, channels and repository bindings are deleted at once.
  • What it reads and stores. metaphi.ai/security.

​
Troubleshooting