Crow Shay
Home Discord Add Bot Dashboard

Documentation

Crow Shay Member Guide

Crow Shay is a craft tracking bot built for crochet and fiber arts communities. It lives right inside Discord, so you can log your WIPs, browse your yarn stash, save patterns, and track rows and rounds — all without leaving the server.

All your data is private by default, and you can choose what to share with the community.

Add to Your Server Join the Discord
🧶
WIP Tracking
/wip add
🪺
Yarn Stash
/yarn add
📖
Patterns
/patterns add
🔢
Row Counter
/counter
🏷️
Pricing
/price calculator
🎲
Stash Ideas
/stashideas suggest

First steps

Quick Start

New to Crow Shay? Here's how to get up and running in a few minutes.

⚙️

Server admins: required setup first. Before members can use scheduled features like WIP Wednesday or CAL check-ins, a server admin or owner needs to run /setup timezone and any other relevant setup commands. See the admin setup guide →

  1. 1
    Run /hello to see an introduction to the bot and everything it can do.
  2. 2
    Set up your profile with /profile intro — add your display name, pronouns, and favorite craft so the community knows who you are.
  3. 3
    Add your first WIP with /wip add — give it a name, choose a craft type, and optionally add notes or an image.
  4. 4
    Add some yarn to your stash with /yarn add — Crow Shay will search Ravelry for yarn details automatically.
💡

Run /commands at any time for a full list of available commands organized by category.

Feature

WIP Tracking

WIP stands for Work In Progress. These are your active craft projects. Crow Shay lets you add, update, and complete WIPs with images, notes, and craft type — all in one place.

Command Description
/wip add Add a new WIP — name, craft type, notes, and optional image
/wip view Browse your active WIPs (shows projects across all shared servers when viewing your own)
/wip update Update progress, notes, image, or privacy setting
/wip complete Mark a WIP as finished — counts toward the server's annual goal
/wip remove Remove a WIP permanently
/view complete Browse your completed projects, filtered by craft
💡

Completing a crochet WIP via /wip complete counts toward the server's annual goal. Other craft types (knitting, embroidery, etc.) are tracked in your history but don't increment the server goal.

Feature

Row & Round Counter

Keep track of rows, rounds, or repeats while you work — without losing count. Your progress accumulates across multiple sessions.

Run /counter to get started. You'll be able to:

  1. 1
    Pick one of your active WIPs from the list.
  2. 2
    Choose a counting mode: rows, rounds, or repeats.
  3. 3
    Use the +1, +5, and +10 buttons to count up as you go.
🔢

Your count and total session time accumulate across multiple Discord sessions. The counter automatically deactivates when you complete the WIP.

Feature

Yarn Stash

Log what you own, track what you've used, and keep your stash organized. When you add yarn, Crow Shay automatically searches Ravelry for yarn details — you can also enter everything manually if the yarn isn't in the database.

Command Description
/yarn add Add yarn to your stash — searches Ravelry for details automatically, or enter manually
/yarn stash Browse your full stash with pagination (cross-server for your own stash)
/yarn random Get a random yarn from your stash for inspiration
/yarn remove Archive a yarn as used, gifted, traded, or donated
/yarn restore Restore an archived yarn back to active
/yarn leaderboard See the top stash-busters ranked by yardage used

Feature

Pattern Journal

Save and organize patterns you own or want to make. Log the URL, craft type, cost, format (written, video, book), source, and your own notes.

Command Description
/patterns add Save a pattern to your journal — name, craft, cost, format, and notes
/patterns view Browse your pattern journal (cross-server when viewing yourself)
/patterns remove Remove a pattern from your journal
/patterns restore Restore a previously removed pattern

Feature

Project Pricing

Calculate a suggested retail price for completed projects. Great if you sell your work and want a consistent way to figure out what to charge.

Command Description
/price calculator Enter materials cost, labor hours, and overhead to get a suggested retail price
/price view Browse all your priced projects with full breakdowns

Feature

Stash Ideas

Not sure what to make next? Crow Shay has a whole family of stash idea generators to spark some inspiration.

Command Description
/stashideas suggest Random project + stitch + yarn weight + challenge combo
/stashideas bold Bold and dramatic project ideas
/stashideas chaotic Wild and unpredictable ideas
/stashideas pastel Soft and dreamy project ideas
/stashideas easy Quick and simple projects
/stashideas challenge A stash-busting challenge
/stashideas amigurumi Amigurumi inspiration
/stashideas yarncolors Random yarn color palette

Community

Community Features

Annual Goal

Your server has a shared annual crochet project completion goal. Every time you complete a crochet WIP with /wip complete, it contributes to the server total. Check progress anytime:

/annualgoal show

💡

Only crochet projects count toward the annual goal. Projects in other craft types are tracked in your personal history but don't increment the server total.

Leaderboard

See who's been the most prolific crafter in the server with /leaderboard.

WIP Wednesday

Your server may have automated WIP Wednesday posts — a weekly check-in where members share what they're working on. Look for the post in the designated channel every Wednesday and share your progress!

CAL (Crochet-Along)

If your server is running a CAL, the bot posts weekly check-ins automatically. Join in by replying to those posts and sharing your progress.

Privacy

Privacy & Your Data

🔒

Your data is yours. When you view your own WIPs, stash, patterns, or profile, Crow Shay shows results across all servers where you share the bot. When viewing someone else's data, you only see what's in the current server.

A few things worth knowing:

  1. 1
    WIPs can be set to private using /wip update. Private WIPs are visible to you but not to other members browsing the server.
  2. 2
    Your profile intro is optional. You control what information (name, pronouns, favorite craft) is displayed to others.
  3. 3
    Data is stored per-server. Leaving a server does not automatically delete your data from that server's database.

Web Dashboard

The Crow Shay Dashboard

The Crow Shay web dashboard gives you a browser-based view of all your crafting data — across every server — in one place. Browse your stash, check your WIPs, and revisit finished projects without opening Discord.

  1. 1
    Visit crowshay.app/dashboard or click Open Dashboard from the home page.
  2. 2
    Click Login with Discord and authorize Crow Shay to read your basic profile info.
  3. 3
    Your data loads automatically — Profile, WIPs, Completed Projects, Stash, Patterns, and Counters, all in the sidebar.
📌

The dashboard is read-only — you can view and browse all your data, but adding or editing items still happens through Discord commands.

Crow Shay is cozy, encouraging, and non-judgmental.
Progress — whatever form it takes — always counts. 🧶

For Server Admins

Required Setup

Run these commands in order before any scheduled features will work. Admin or mod role required.

⚠️

Always run /setup timezone first. Without a timezone, scheduled posts will not fire correctly.

1. Set Your Timezone

Run /setup timezone and enter an IANA timezone name — for example America/New_York, America/Chicago, or Europe/London. UTC is intentionally blocked. Need to look yours up? Visit addevent.com timezone lookup.

2. Configure WIP Wednesday

Run /setup wip-wednesday to enable the automated weekly check-in post. You'll choose the channel, post time (24-hour format, e.g. 14:30), and an optional role to ping. Running the command automatically enables it — no separate toggle needed.

3. Configure a CAL (Crochet-Along)

Run /setup cal to set up structured weekly check-ins over a 1–4 week CAL event. Set the start date, duration, post time, channel, and optional role ping. The bot adjusts messaging for the final week automatically. Admins and mods can also trigger a check-in early with /cal checkin.

4. Configure Milestone Announcements

Run /setup milestones to enable shout-outs when the server hits annual goal thresholds — 25%, 50%, 75%, and 100%. Set the channel and an optional role ping.

💡

All scheduled features use the timezone set in step 1. Post times are always in 24-hour HH:MM format — e.g. 09:00 or 20:30.

For Server Admins

Annual Goal

Set a server-wide project completion goal for the year. The goal tracks one craft type at a time — crochet by default, but admins and mods can change it.

Command Description Who
/annualgoal set Set a new annual goal and optionally choose which craft type counts toward it Admin / Mod
/annualgoal show Display current goal progress — members can run this too Everyone
/annualgoal reset Reset the completed count (useful at the start of a new year) Admin only
🧶

Only completed WIPs matching the configured craft type increment the server total. Other craft types are tracked in members' personal history but don't count toward the goal.

For Server Admins

Mod Role

Grant a trusted moderator role access to all staff commands without full admin permissions:

/setup modrole [role]

The assigned role can use all /setup subcommands (except /setup modrole itself), /cal checkin, /disable, and /annualgoal set. Only one mod role can be configured per server at a time. /setup modrole and /annualgoal reset remain admin-only.

For Server Admins

Disabling Features

Each scheduled feature can be paused without losing its configuration. To re-enable any feature, simply re-run the corresponding /setup command.

Command Description Who
/disable cal Disables CAL check-ins and clears the schedule. Channel and role config are kept. Admin / Mod
/disable wip-wednesday Disables WIP Wednesday posting. Channel and role config are kept. Admin / Mod
/disable milestones Halts milestone announcements. Channel and role config are kept. Admin / Mod

For Server Admins

Admin & Mod Command Reference

Command Description Who
/setup timezone Set the server IANA timezone — required first Admin / Mod
/setup wip-wednesday Enable and configure WIP Wednesday Admin / Mod
/setup cal Enable and configure CAL check-ins Admin / Mod
/setup milestones Enable and configure milestone announcements Admin / Mod
/setup modrole Assign a role that can use all staff commands Admin only
/disable cal Disable CAL check-ins (retains config) Admin / Mod
/disable wip-wednesday Disable WIP Wednesday (retains config) Admin / Mod
/disable milestones Disable milestone announcements (retains config) Admin / Mod
/annualgoal set Set the server annual goal and craft type Admin / Mod
/annualgoal reset Reset goal completion count Admin only
/cal checkin Manually post a CAL check-in for a specific week Admin / Mod
/export-wips Export all server WIPs to a CSV file Admin only
/backup Manually back up all databases Owner only
/maintenance Toggle maintenance mode Owner only
💾

Crow Shay automatically backs up all databases daily at 3:00 AM with 30-day retention. If a member leaves your server, their data remains in your guild's database — use /export-wips to keep records before removing members if needed.