User Guide

Installation, command reference, admin operations, insights, billing, and troubleshooting

I. Installation and Setup

Install from website

• Go to myelin-engine.me.
• Click Add to Slack and approve required app scopes.
• After OAuth completes, the workspace token is saved and the app is ready for /vent commands.

Set leadership destination channel

• Use /vent settings (workspace admin/owner only).
• Select the destination conversation for leadership delivery (public, private, or DM-supported conversation select).
• Save to route future anonymous feedback summaries to that workspace destination.

Workspace install checks

• If users see "Myelin is not installed for this workspace yet," an admin must re-run Add to Slack.
• If settings cannot be saved, verify the app has valid workspace token storage and permissions.

II. Command Reference

/vent

• Opens a modal to submit anonymous feedback.
• The modal collects:
• Details (multiline text input).
• Urgency Level (Low, Medium, High - Action Required).
• After submit, the user gets an ephemeral confirmation in Slack.
• Identity is masked in leadership-facing output; routing is based on workspace configuration.

/vent settings (Workspace admin/owner only)

• Opens a workspace settings modal.
• Used to set or change the leadership destination channel.

/vent admin-add @user (Workspace admin/owner only)

• Adds a user to Myelin app-admins for that workspace.
• Accepts mention format (for example @name) or raw Slack user ID.

/vent admin-remove @user (Workspace admin/owner only)

• Removes a user from Myelin app-admins for that workspace.
• Use this when rotating admin responsibilities.

Rate limits and free-tier limits

• In-memory abuse protection limits rapid submit bursts per user and per workspace.
• If free-tier limits are reached, users see: "Limit reached. Upgrade to Pro at myelin-engine.me."

III. Understanding Insights

Sentiment Analysis

• Negative/Urgent: high-urgency or critical language requiring immediate attention.
• Negative: blockers, stressors, or unresolved concerns.
• Neutral: informational or mixed signals.
• Positive: improvement, wins, or healthy sentiment.

Topic Tagging

Myelin Engine automatically classifies feedback into practical triage topics, including:

• Facility
• Leadership
• Process
• Tooling
• Compensation
• General

Threaded anonymity bridge

• When enabled by tier/access rules, leadership thread replies can be relayed back to the original submitter via DM.
• User DM follow-ups can be routed back into the linked leadership thread.

IV. Billing and Plans

• Myelin supports Free, Pro, and Enterprise plan logic.
• A 14-day trial window is tracked per workspace.
• Billing events are processed via Stripe webhook handling with signature verification and idempotency protections.
• Home tab upgrade actions can show plan-specific checkout options.

V. Dashboard and APIs

• /dashboard: Enterprise-only admin dashboard view.
• /api/stats: Aggregated stats endpoint requiring workspace/admin context.
• /health: Returns OK for uptime checks.

VI. Troubleshooting

The bot is not responding

• Confirm the app is installed in the workspace.
• Confirm the workspace has a valid saved bot token (re-run Add to Slack if needed).
• Confirm leadership routing is configured with /vent settings.
• Check service health at /health and inspect container logs.

Need support?

Contact support at support@myelin-engine.me.