Skip to content

adityaarsharma/pickle

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

83 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ₯’ Pickle

In a pickle? Pickle sorts it.

Every morning, 200+ messages across ClickUp and Slack. Half are noise. A few are decisions waiting on you. Pickle reads everything, keeps the few that matter, and drops them in your personal task board β€” ranked by what YOU actually do.

Built by Aditya Sharma. MIT licensed. Free forever. v2.7.9


The problem

You wake up. Open ClickUp. Open Slack. 47 unread threads. You scan, skim, miss the one DM where a teammate's been waiting 2 days for your approval. By 11am, someone pings: "any update on the thing I sent Monday?"

The problem isn't you. Your attention is spread across channels, DMs, task comments, and threaded replies β€” and no single view tells you "here's what needs you right now."

What Pickle does

Mode A β€” Inbox πŸ“₯ β€” Every message that needs your action:

  • DMs and group DMs you're in (questions, approvals, decisions)
  • Channel messages where you're @mentioned
  • Task comments on tasks you own or watch
  • Docs where someone tagged you
  • Reminders others set for you

Mode B β€” Follow-up Tracker πŸ” β€” Every thread where someone owes YOU something:

  • You asked β†’ they said "will do" β†’ 3 days of silence
  • You asked for a file β†’ they replied "sure" but never sent it
  • You set a recurring ask β†’ updates stopped after Tuesday

Pickle creates prioritised tasks in your private "Task Board - By Pickle", ranked by urgency and by what your role actually cares about. You go from 47 threads to 7 tasks.

What makes Pickle different

🎯 Scored by YOUR role, not a generic rule

Pickle asks your role and one line about what you do day-to-day on first run. A manager sees approvals and blockers ranked higher; a team member sees their assigned tasks and pending replies. Role only reorders β€” it never filters anything out.

πŸ“¬ Catches DMs that others miss

In a private DM or group DM that includes you, every unanswered question is yours β€” even if it's technically addressed to someone else in the thread. That's how work actually flows. Pickle knows this.

🌐 Reads intent, not just keywords

Teams write in whatever language is natural β€” and Pickle reads the meaning, not the exact phrase. "Can you confirm?", "please approve", and any local-language equivalent all register the same way.

πŸ”” Notifies you the moment a scan finishes

Each skill fires its own notification when done β€” ClickUp skills create a deadline task in your board, Slack skill sends a Slackbot reminder. No Business plan required. Nothing sent to any group or channel.

🚫 Never auto-sends

Every follow-up message is drafted, shown to you, and only sent after you say so. If you've already nudged someone twice, Pickle refuses to send a third β€” it suggests you talk to them directly.

πŸ”’ Runs on your machine

No Pickle server exists. Your chat data never leaves your laptop.

πŸ’° Free forever

Both supported paths are 100% free. No trial, no paid tier, no credit card.


Two versions of Pickle

πŸ§‘β€πŸ’Ό Pickle Manager

For team leads and managers.

Command What it does Notification
/pickle-clickup [window] ClickUp inbox β€” what needs your action ClickUp πŸ”” task
/pickle-slack [window] Slack inbox β€” same, from Slack Slackbot reminder
/pickle-clickup-team-report [channel] [window] Team performance pulse β€” commitment vs execution ClickUp πŸ”” task
/pickle-update Update Pickle to the latest version β€”

πŸ‘€ Pickle Team Member

For individual contributors.

Command What it does Notification
/pickle-clickup [window] ClickUp inbox β€” what needs your action ClickUp πŸ”” task
/pickle-slack [window] Slack inbox β€” if your team uses Slack Slackbot reminder
/pickle-update Update Pickle to the latest version β€”

The only difference: Managers get /pickle-clickup-team-report. Team members don't.

Both versions use the same private "Task Board - By Pickle". Each ecosystem stays completely isolated β€” ClickUp data never crosses into Slack and vice versa.


Install

Open Claude Code and paste the relevant message into chat β€” Claude runs the install for you.

πŸ§‘β€πŸ’Ό For managers and team leads

Install Pickle (manager version) by running: curl -fsSL https://raw.githubusercontent.com/adityaarsharma/pickle/main/install-manager.sh | bash

πŸ‘€ For team members

Install Pickle (team member version) by running: curl -fsSL https://raw.githubusercontent.com/adityaarsharma/pickle/main/install-team.sh | bash

Claude will show a summary of what the script does β€” click Yes to confirm. The guided setup (/pickle-setup) runs automatically after install and walks you through everything: name, role, ClickUp or Slack or both, connection method. Takes about 2 minutes.

Quit Claude Code fully (Cmd+Q) and reopen when done.

Repo: github.com/adityaarsharma/pickle


Daily usage

For managers:

/pickle-clickup            # scan ClickUp last 24 hours
/pickle-clickup 7d         # last week
/pickle-clickup 24h followup   # scan + draft follow-up reminders

/pickle-slack              # same for Slack
/pickle-slack 7d

/pickle-clickup-team-report marketing-hq        # team pulse
/pickle-clickup-team-report engineering-hq 14d  # two-week view

For team members:

/pickle-clickup        # scan ClickUp inbox
/pickle-clickup 7d     # past week

/pickle-slack          # scan Slack inbox (if installed)

ClickUp data and Slack data stay completely separate β€” never mixed.


Pickle Manager β€” Team Performance Reports

/pickle-clickup-team-report marketing-hq        # weekly report for the marketing team
/pickle-clickup-team-report engineering-hq 14d  # 2-week view for engineering
/pickle-clickup-team-report design-hq 7d        # design team pulse

Pickle Manager scans what your team said they'd do (ClickUp chat) vs what they actually tracked (task cards, time logs, comments). Per person: delivery rate, time efficiency, update compliance, channel presence. Posts a smart, non-offensive report back to the department channel. Flags underperformers to you directly.

What it analyses:

  • πŸ“‹ Commitments made in chat β†’ matched to real task completion
  • πŸ• Time tracked vs estimated (per-task efficiency)
  • 🧟 Zombie tasks β€” assigned but untouched for 5+ days
  • πŸ’¬ Task documentation quality (descriptions, progress comments)
  • πŸ‘» Ghost mode β€” team members silent for 40%+ of the window
  • πŸ“‰ Trends over time β€” is someone consistently slipping, or improving?

Truly Done standard: A task only counts as complete when ALL THREE are true β€” status closed + description filled + time tracked.

Scope: ClickUp only. Requires ClickUp MCP connected.


Update

/pickle-update

Auto-detects what you have, pulls the latest, tells you to Cmd+Q and reopen Claude Code. Your tokens, role, and task history stay untouched.


How Pickle connects to ClickUp / Slack

πŸ”΅ ClickUp

Path Best for Setup
Official Claude Connector (recommended) Personal Claude accounts claude.ai β†’ Settings β†’ Connectors β†’ ClickUp β†’ Connect. 2 clicks.
Pickle's own MCP (personal token) Shared Claude accounts Paste your ClickUp API token during setup. Runs locally, free.

Getting your ClickUp API token:

  1. Open app.clickup.com β†’ click your avatar β†’ Settings
  2. Left sidebar β†’ Integrations & ClickApps β†’ ClickUp API
  3. Click Generate β†’ copy the pk_… token
  4. Paste it when /pickle-setup asks. Stays in ~/.claude.json β€” never uploaded.

πŸ’¬ Slack

Connect via claude.ai β†’ Settings β†’ Connectors β†’ Slack β†’ Connect. 2 clicks, free.

If you're on a shared Claude account or a locked workspace and need a personal token path, see the advanced Slack setup in the wiki.


Every surface covered

Source ClickUp Slack
Channels βœ… βœ…
Direct messages βœ… βœ…
Group DMs βœ… βœ… (mpim)
Task comments βœ… β€”
Threaded replies βœ… βœ…
Task descriptions / mentions βœ… β€”
Docs / canvas mentions βœ… β€”
Reminders βœ… βœ…

What Pickle will never do

  • ❌ Auto-send any message without your confirmation
  • ❌ Post in public channels or group DMs on your behalf
  • ❌ Hide a message because your role "doesn't care" about it
  • ❌ Send a third follow-up to someone you've already nudged twice
  • ❌ Upload your chat data anywhere β€” it all stays on your machine

Uninstall

rm -rf \
  ~/.claude/skills/pickle-clickup \
  ~/.claude/skills/pickle-slack \
  ~/.claude/skills/pickle-update \
  ~/.claude/pickle-mcp \
  ~/.claude/pickle

Then remove the mcpServers.clickup and/or mcpServers.slack blocks from ~/.claude.json.


Credits

Built by Aditya Sharma. MIT licensed. Contributions welcome.

About

πŸ₯’ Pickle β€” In a pickle? Pickle sorts it. Claude Code skill that scans Slack + ClickUp, extracts what needs you, tracks follow-ups. /pickle-slack Β· /pickle-clickup β€” by Aditya Sharma

Topics

Resources

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors