Get started with Tag
Connect Tag to Slack with Codex or the installer, then complete your first task in a thread.
Connect Tag to Slack, then try a task in a thread. You can set up with help from Codex or run the installer yourself.
Before you begin
Use a Mac or Linux computer that can stay awake and connected to the internet while Tag handles requests. You'll need:
- Codex CLI installed, signed in, and able to run tasks on that computer.
- Permission to create and install a Slack app in your workspace. Your workplace may require an administrator to approve it.
Only you can ask your Tag to work. Other people in the channel can read your requests and its replies. See Your own Tag for how Tag uses your agent's files, tools, and connected accounts.
Claude support is coming soon.
Set up Tag
Choose one setup method. Both use the same installer and Slack setup flow.
Install the setup skill from your terminal. This command requires Node.js and npm:
npx skills add klovr-co/hover-tag --skill hover-tag-setup -a codex -gOpen a new Codex session and ask:
Use the hover-tag-setup skill to set up Tag for me.Codex checks what's already installed, helps with missing prerequisites,
and installs Tag if needed. It then asks you to run tag setup in your own
terminal to authorize Slack and choose your app and channels.
Use your own Slack account as the owner. Review the channel list, history window, and invitation policy before finishing. New setups include channels the app has already joined; later invitations also make channels eligible for replies and history indexing.
Complete the prompts in your terminal. If credentials need manual entry, enter them there, not in your Codex conversation.
Return to Codex when setup finishes or pauses. It can check the connection or help diagnose the failed step. Once Tag is connected, continue to Try your Tag in Slack below.
Start Tag
Once setup is saved, this is the command to bring Tag online:
tag startTag runs in the background, so you can close this terminal. Keep the computer
awake and connected. After restarting your computer, run tag start again;
you don't need to repeat setup.
Setup does not start services or index history. After tag start completes,
you can check the connection anytime with tag status.
Try the task below to check that your Tag answers in Slack.
Try your Tag in Slack
In a channel connected during setup, post a short planning note. You can use this example or write one for your own work:
We need to prepare the launch. Maya will finish the FAQ by Tuesday. Jules will test signup by Wednesday. Nobody has taken the support briefing yet.
Reply in that message's thread and mention your Tag. These examples use Maya's Tag; select your own app's mention from Slack's suggestions. The replies below are illustrative:
@Maya's Tag turn this into a checklist with owners and deadlines. Flag anything missing.
Check that the reply appears in the same thread, keeps the two assigned tasks and their deadlines, and flags the missing owner and deadline for the support briefing. That confirms Tag received your request, ran Codex, and returned a result to Slack.
Continue in the same thread:
@Maya's Tag I'll handle the support briefing on Thursday. Update the checklist.
The updated checklist should include your follow-up alongside the earlier tasks. Tag uses the thread messages as context.
Once this works, explore Working with files or Adding integrations.
Need help?
Run tag doctor to check for problems, then follow
Troubleshooting. Stop Tag at any time with tag stop.
Last updated