Getting Started

1. Install Smithy

Click the Add to Slack button on our homepage to install Smithy into your Slack workspace. You'll be asked to authorize a set of permissions that Smithy needs to manage threads on your behalf.

Once installed, Smithy is available in every channel it's invited to, but won't enforce threading until you enable Thread Mode.

2. Enable Thread Mode

In any channel where you want Smithy to enforce threading, type:

That's it. From now on, any top-level message posted in that channel will automatically be converted into a managed thread. To disable Thread Mode, use /smithy off.

3. Authorize for Cleanup (Optional)

When Smithy converts a message into a thread, it can also delete the original top-level message to keep the channel clean. This requires each user to grant Smithy permission by running:

This step is optional. Without authorization, the original message stays in the channel alongside the new thread. See Message Cleanup for details.

4. Start Using Threads

With Thread Mode enabled, post a message in the channel. Smithy will:

1. Detect the new message
2. Create a managed thread with a subject and content
3. Optionally clean up the original message (if authorized)

You can also create threads manually using the /thread new slash command. See Slash Commands for the full reference.