Automate Slack with Codex
Send channel messages, schedule announcements, share media, and streamline team communications — all from the command line or through your AI agent.
Please make sure there is always a human in the loop.
Post to Slack in Seconds
Terminal
# Install the skill
npx skills add gitroomhq/postiz-agent
# Set your API key
export POSTIZ_API_KEY=your_api_key
# Find your Slack integration
postiz integrations:list
# Send a message to a Slack channel
postiz posts:create \
-c "Team update: deployment complete" \
--settings '{"channel":"C12345"}' \
-i "your-slack-integration-id"Slack-Specific Features
Channel Messaging
Post messages to any Slack channel your bot has access to. Share updates, announcements, and notifications automatically.
Scheduled Messages
Schedule messages for the perfect time. Queue up announcements, reminders, and updates to post when your team is most active.
Media Sharing
Attach images, files, and rich media to your Slack messages. Share screenshots, reports, and visual updates with your team.
Team Communications
Automate recurring team updates, standup summaries, and status reports across multiple channels simultaneously.
Bot Integration
Leverage Slack bot tokens for seamless posting. Your AI agent authenticates once and posts on behalf of your workspace.
Multi-Channel Posting
Target different channels for different content types. Send engineering updates to #dev and marketing wins to #general.
How It Works
Find Your Slack Integration
List your connected accounts and grab your Slack integration ID. You can also fetch available settings to see what options are supported.
Discovery
# List all integrations
postiz integrations:list
# Filter for Slack
postiz integrations:list | jq \
'.[] | select(.identifier=="slack")'
# Get Slack settings schema
postiz integrations:settings <slack-id>Choose Your Channel
Identify the Slack channel ID where you want to post. You can find channel IDs in Slack by right-clicking a channel and selecting 'View channel details'.
Channel Setup
# Channel IDs look like C12345
# Find them in Slack:
# Right-click channel > View channel details
# The ID is at the bottom of the dialog
# Or use Slack's API directly
# to list channels programmaticallyCreate Your Post
Send a message to your Slack channel with the channel ID in settings. Schedule it for later or post immediately.
Post Creation
postiz posts:create \
-c "Team update: deployment complete" \
--settings '{"channel":"C12345"}' \
-i "slack-id"
# Schedule for later
postiz posts:create \
-c "Reminder: standup in 15 minutes" \
-s "2025-01-15T09:45:00Z" \
--settings '{"channel":"C12345"}' \
-i "slack-id"Slack Settings Reference
Every Slack post accepts these platform-specific settings via the --settings flag.
| Field | Type | Description |
|---|---|---|
__type | string | Must be "slack" |
channel | string | Slack channel ID (e.g. C12345) |
Common Configurations
Copy-paste these settings for common Slack posting scenarios.
General Channel Announcement
settings.json
{
"channel": "C12345"
}Engineering Updates
settings.json
{
"channel": "C67890"
}Marketing Channel Post
settings.json
{
"channel": "CABCDE"
}What is Codex?
Codex is OpenAI's autonomous coding agent that handles software engineering tasks — writing features, fixing bugs, and answering questions about your codebase. It works via CLI and IDE integrations, and can execute shell commands like Postiz.
CLI & IDE Native
Codex runs from your terminal or IDE. It executes shell commands directly, making Postiz integration seamless — no extra configuration needed.
Autonomous Execution
Codex works in sandboxed cloud environments, autonomously running commands, reading output, and chaining multi-step workflows like social media posting.
Parallel Tasks
Run multiple Codex tasks simultaneously. Schedule posts to different platforms in parallel while Codex handles other coding work.
How Postiz Works with Codex
Codex discovers Postiz when you install it globally. It reads the SKILL.md to understand available commands and can autonomously chain them for social media workflows.
- ✓Install Postiz Agent globally with npx skills add
- ✓Codex reads the SKILL.md and learns all Postiz commands
- ✓POSTIZ_API_KEY must be set in environment
- ✓Codex executes commands in sandboxed environments
- ✓Works alongside your coding tasks in parallel
Install Postiz
# Install the Postiz skill
npx skills add gitroomhq/postiz-agent
# Set your API key
export POSTIZ_API_KEY=your_api_key
# Codex discovers Postiz commands
# from the SKILL.md automatically
codex "list my social media integrations"Slack Posting with Codex
Tell Codex what to post from your terminal or IDE — it discovers your integrations via Postiz and handles the entire publishing workflow.
CLI Workflow
Terminal and IDE integration
Tell Codex what to post from your terminal or IDE — it discovers your integrations via Postiz and handles the entire publishing workflow.
Codex CLI
$ codex "Post to Slack about our
new feature launch, schedule for
tomorrow at 9am"
Codex: I'll handle that.
Running: postiz integrations:list
Found your Slack integration.
Running: postiz posts:create ...
Done! Your post is scheduled.
Post ID: abc-123Parallel Tasks
Multiple tasks at once
Codex can handle multiple tasks in parallel. Schedule posts to different platforms while it works on other coding tasks simultaneously.
Codex Parallel Tasks
# Run multiple posting tasks in parallel
$ codex "Schedule a post about our
launch to X for tomorrow 9am" &
$ codex "Write a LinkedIn article
about our new feature and schedule
for tomorrow noon" &
$ codex "Fix the bug in auth.ts"
# All three tasks run simultaneouslyWhy Codex + Postiz for Slack
Codex's autonomous execution makes Postiz a natural fit. The agent reads the SKILL.md to understand every available command, then autonomously chains them together for Slack workflows.
- ✓CLI-native — runs from your terminal or IDE
- ✓Autonomous execution in sandboxed environments
- ✓Parallel task support — post while coding
- ✓Channel targeting applied automatically based on your instructions
- ✓Cross-post to Slack + other platforms in a single session
- ✓Powered by OpenAI's most capable models
SKILL.md (auto-discovered)
---
name: postiz
description: Social media automation
CLI for scheduling posts across
30+ platforms including Slack
metadata:
codex:
requirements:
env:
- POSTIZ_API_KEY
binaries:
- postiz
---
# Available Commands
- postiz integrations:list
- postiz integrations:settings <id>
- postiz posts:create
- postiz upload <file>
- postiz analytics:platform <id>
# Slack Settings
channel (required)Also Works with Claude Code
Postiz Agent works as a CLI tool with any AI agent that can execute shell commands — including Anthropic's Claude Code.
Claude Code
by Anthropic
Claude reads the SKILL.md file to learn all available Postiz commands, then autonomously discovers your Slack integration, identifies the correct channel, and sends your message.
Claude Code
> Post a deployment update to #engineering
on Slack
Claude will automatically run:
postiz integrations:list
postiz posts:create \
-c "Deployment v2.4.1 complete" \
--settings '{"channel":"C12345"}' \
-i "slack-id"Slack + Other Platforms
Post the same announcement to Slack and other platforms in a single command. Each platform gets its own settings.
Terminal
# Post an announcement to Slack and Discord simultaneously
postiz posts:create \
-c "New feature released: dark mode is here!" \
-s "2025-01-15T09:00:00Z" \
--settings '{"channel":"C12345"}' \
-i "slack-id,discord-id"
# Batch schedule a week of Slack updates
for day in 1 2 3 4 5; do
postiz posts:create \
-c "Daily standup reminder - Day $day" \
-s "2025-03-0${day}T09:00:00Z" \
--settings '{"channel":"C12345"}' \
-i "slack-id"
doneStart posting to Slack
Install Postiz Agent and automate your Slack communications with AI-powered scheduling and messaging.
Ready to get started?
Grow your social media presence with Postiz.
Schedule, analyze, and engage with your audience.
Open-source social media scheduling tool
