MeowchiBot Documentation
Everything Meowchi can do — DM me in Slack or @mention me in a channel.
Approval Workflow
Approve or Reject Tasks
React to task suggestion cards to approve or reject them. Approved tasks are created in Jira immediately; rejected tasks are archived.
Add a reaction to any task card Meowchi posts.
"React with ✅ to create the Jira issue""React with ❌ to skip it"Edit in Threads
Reply in a task card's thread to revise it before approving — change the title, priority, assignee, or any other field. After approval, thread replies become Jira update commands.
Reply in the thread of any task card Meowchi posted.
"Change the title to: Implement OAuth2 flow""Set priority to High and assign to me"Configuration
Set Preferences
Save persistent workspace rules that Meowchi follows on every request — default projects, verbosity, naming conventions, and more.
Tell Meowchi a rule to remember.
"Always file tasks to PPM""Use verbose mode""Default priority should be Medium"Feature Requests
File Feature Request
When Meowchi can't handle a request, users can click a button to automatically file a feature request in Jira under the MeowchiBot epic (PPM-2).
Click the "📋 File a feature request" button that appears when Meowchi declines a capability-gap request.
Jira Management
Break Down Issues
Decompose a Jira issue into sub-tasks using AI. Meowchi reads the issue, generates a breakdown, and posts each proposed task as a card for approval.
Give Meowchi an issue key to break down.
"Break down PPM-3 into subtasks""Decompose SED-15"Create Issues
Create new Jira issues, epics, and bulk tasks from natural language. Supports single issues, epics with children, and bulk creation.
DM Meowchi or @mention with what you need — specify the project, type, and description.
"Create a task in PPM: Update the onboarding docs""File a bug in SED: Login page crashes on Firefox""Make an epic called Q2 Platform Cleanup with 3 subtasks""Log a story in WEB and link it to WEB-42"Link Issues
Create relationships between two Jira issues — blocks, relates to, duplicates, or clones.
Name both issue keys and the relationship type.
"PPM-5 blocks PPM-10""SED-42 relates to SED-99""Mark WEB-3 as a duplicate of WEB-1"Query Issues
Search Jira issues, list projects, browse epics, and look up team members. Meowchi translates natural-language questions into JQL.
Ask Meowchi about issues, projects, or people.
"What are my open tasks?""List all epics in the SED project""Show high-priority bugs in PPM""What projects are there?"Update Issues
Modify fields on existing Jira issues — priority, status, assignee, labels, description, parent, and comments. Supports single issues, multiple keys, bulk JQL-based updates, and epic-scope updates with optional status filtering.
Tell Meowchi the issue key and what to change.
"Set PPM-45 priority to High""Assign SED-12 to me""Add a comment to WEB-7: Waiting on design review""Move all tasks in PPM under the Q2 epic""Move OPEN issues in SED-35 to Selected for Development"GitHub @Mention
@mention Meowchi in a GitHub issue or PR comment to create Jira tickets directly from GitHub. A GitHub Actions workflow detects the mention, sends the comment to Meowchi, and posts the reply back as a GitHub comment. The commenter is mapped to their Slack user via the GITHUB_SLACK_USER_MAP env var.
@mention Meowchi in any GitHub issue or PR comment with your request.
"@meowchi file a bug for this issue in PPM""@meowchi create a task in SED: fix the flaky CI pipeline"Project Structure
Fix Hierarchy
Auto-detect structural problems in a project — orphaned issues, wrong parents, missing hierarchy levels — and propose grouped fixes for approval.
Ask Meowchi to fix or suggest improvements to a project's structure.
"Fix the PPM hierarchy""Suggest improvements to the SED project structure"View Hierarchy
Display the full issue tree for a project or epic as a text diagram. Shows parent-child relationships across all non-Done issues.
Ask Meowchi for a project or epic tree.
"Show me the PPM project tree""What's the hierarchy under SED-100?"Status & Tracking
Activity Summary
See a summary of what Meowchi has done recently — tasks created, rejected, and still pending. Pulls from both the approval queue and Jira.
Ask Meowchi what it has been doing.
"What have you done this week?""Show me your activity for the last 3 days"Check Pending
List all task suggestions that are still waiting for your approval (pending or needs changes).
Ask Meowchi what needs your review.
"What's pending?""Show tasks waiting for approval"Task Extraction
Attach Files
Attach files from Slack to an existing Jira issue. Supports images (PNG, JPEG, GIF, WebP), documents (PDF, TXT, CSV), and Office files (DOCX, XLSX) up to 20 MB.
Send a file in your DM and tell Meowchi which issue to attach it to.
"Attach this to PPM-45" (with file attached)"Add this screenshot to SED-12" (with image attached)Process CSV Files
Extract Jira task suggestions from a CSV file attached in Slack. AI reads the CSV contents (no fixed column format required) and posts each proposed task as an approval card.
Attach a CSV file to your DM and ask Meowchi to process it.
"Process this CSV" (with file attached)"Extract tasks from the attached spreadsheet"Process Transcripts
Extract Jira task suggestions from a Google Drive document (meeting notes, transcripts, specs). AI reads the doc, identifies actionable items, and posts each as an approval card.
Share a Google Drive link and ask Meowchi to extract tasks.
"Suggest tasks from this doc: [Google Drive link]""Process the meeting notes in this doc: [link]"Team Engagement
Outreach Replies
Automatically handles replies from people who were chased up. Their response is rephrased and posted as a Jira comment, and the original requester gets notified.
No action needed — this is automatic. When someone replies to an outreach DM, Meowchi routes their response back.
Outreach
Chase up Jira issues, audit epics for missing fields, or DM team members on your behalf. Meowchi identifies the right people and sends transparent messages that include who requested it.
Ask Meowchi to chase someone up, audit an epic, or message a person.
"Chase up PPM-34""Audit PPM-2 for missing estimates""Message Alice about the SED launch timeline"Post to Channel
Power users can tell Meowchi to post a message into any Slack channel the bot has access to.
Tell Meowchi to post or announce something in a channel.
"Post in #general: standup is cancelled today""Announce in #engineering that we shipped the new feature"General
Ask Anything
Ask questions, get help, or have a general conversation. Meowchi can explain how it works, summarize threads, or answer questions about the team's workflow.
Just talk to Meowchi naturally.
"What can you do?""How does the approval process work?""Summarize this thread"Patch Notes
v1.2.0 2026-03-05
Added
- GitHub integration: @mention Meowchi in GitHub issue/PR comments to create Jira tickets
- GitHub Actions workflow template — no GitHub credentials needed in n8n
- Dual response: GitHub comment reply + Slack DM notification to the mapped user
- GitHub-to-Slack user mapping via `GITHUB_SLACK_USER_MAP` environment variable
- Dynamic remote link icons on Jira issues (GitHub icon for GitHub-originated requests)
- Feature request button generates AI-summarised titles via Gemini (e.g. "Allow MeowchiBot to set the active sprint" instead of raw user text)
- Slack conversation link included in Jira feature request tickets
Changed
- GitHub webhook uses synchronous `lastNode` response mode — Actions receives the reply directly
v1.1.0 2026-03-03
Added
- Inline documentation system — usage instructions live in code, compiled into a docs page at `/docs/`
- Version tracking with semver, build date, and git SHA
- "Docs" button on the kiosk web UI
- Structured changelog for patch notes
v1.0.0 2026-02-25
Added
- Core DM pipeline: message → intent classification → Jira action
- 16 intent handlers: create, update, query, link, breakdown, transcript, CSV, attach, hierarchy view/fix, outreach, activity, pending, preferences, general
- Reaction-based approval workflow for task cards
- Thread revision support (edit cards before creation, Jira updates after)
- Google Drive transcript processing
- CSV file task extraction
- Project hierarchy visualization and auto-repair
- Team outreach and chase-up messaging
- Persistent workspace preferences via Config sheet
- Kiosk web UI with voice I/O and Google OAuth