Documentation

Everything you need to get started with SpekAI and make the most of it.

Getting Started

Installation

Generating Tickets

Basic Flow

1. Highlight text on any web page — Slack messages, Confluence docs, emails, meeting notes, PRDs, or anywhere else.
2. Open SpekAI by clicking the extension icon. Your highlighted text will appear in the "Captured Text" field.
3. Configure the ticket using the dropdowns for type (Story, Bug, Task, Epic), priority, project, and sprint.
4. Click "Generate Ticket" and the AI will create a structured ticket with title, description, acceptance criteria, edge cases, and labels.
5. Review and edit. Every field is editable inline. Change the title, modify criteria, or adjust labels before sending.
6. Send or copy. Push the ticket directly to your connected tool, or copy it to your clipboard.

Context Menu

Right-click on any selected text and choose "Generate ticket" from the context menu. This opens SpekAI with the selected text already captured.

What the AI Generates

For each ticket, SpekAI produces:

• Title — a concise summary of the work
• Description — a detailed explanation of what needs to be done
• Acceptance Criteria — specific, testable conditions for completion
• Edge Cases — potential issues and scenarios to watch for
• Suggested Labels — relevant tags for categorization
• Type & Priority — inferred from the text, overridable in the config bar

Connecting Jira

SpekAI connects to Jira Cloud using API token authentication.

Setup

1. Open SpekAI and click the gear icon to open Settings.
2. Select Jira as your platform.
3. Enter your Jira Host (e.g., yourcompany.atlassian.net).
4. Enter the email address associated with your Atlassian account.
5. Generate an API token at Atlassian API Tokens and paste it in.
6. Your projects will load automatically. Select the default project.
7. Click Save.

What Gets Mapped

• Summary — ticket title
• Description — converted to Atlassian Document Format (ADF)
• Issue Type — Story, Bug, Task, or Epic
• Priority — Highest, High, Medium, or Low
• Project — selected from your auto-fetched project list
• Sprint — optionally assign to an active or future sprint (defaults to Backlog)

Connecting Linear

SpekAI connects to Linear using an API key.

Setup

1. Open Settings and select Linear.
2. Go to Linear Settings > API and create a personal API key.
3. Paste the key (starts with lin_api_).
4. Enter your Team ID (found in your Linear team settings URL).
5. Click Save.

What Gets Mapped

• Title — issue title
• Description — native Markdown with acceptance criteria and edge cases
• Priority — Urgent (1), High (2), Medium (3), or Low (4)
• Team — assigned to your configured team

Connecting GitHub

SpekAI creates GitHub Issues using a personal access token.

Setup

1. Open Settings and select GitHub.
2. Go to GitHub Settings > Developer settings > Personal access tokens and generate a token with repo scope.
3. Paste the token (starts with ghp_).
4. Enter the Repository Owner (your username or org name).
5. Enter the Repository Name.
6. Click Save.

What Gets Mapped

• Title — issue title
• Body — Markdown with description, acceptance criteria (as checkboxes), and edge cases
• Labels — auto-applied labels for type (feature, bug, task) and priority (priority:high, etc.)

Connecting Notion

SpekAI creates pages in a Notion database using an integration token.

Setup

1. Open Settings and select Notion.
2. Go to Notion Integrations and create a new integration. Copy the token (starts with secret_).
3. Paste the integration token.
4. Open the Notion database you want tickets pushed to. Click Share and invite your integration.
5. Copy the Database ID from the database URL (the 32-character string after the workspace name and before the ?).
6. Paste the Database ID and click Save.

What Gets Mapped

• Page Title — the "Name" property of the database entry
• Page Content — structured blocks including:
  • Description as a paragraph
  • Acceptance criteria as to-do checkboxes
  • Edge cases as bullet points
  • Type, priority, and labels as a metadata line

Configuration & Defaults

Ticket Defaults

In the Settings panel, you can configure default values that pre-fill when generating tickets:

• Default Type — Story, Bug, Task, or Epic (Jira and GitHub)
• Default Priority — Critical/Urgent, High, Medium, or Low (all platforms)

These can always be overridden in the config bar before generating.

AI Settings

• Include edge cases — toggle whether the AI generates edge case suggestions (on by default)
• Suggest labels — toggle whether the AI suggests labels for the ticket (on by default)

Switching Platforms

You can switch between Jira, Linear, GitHub, and Notion at any time from Settings. Select a different platform, enter its credentials, and save. Only one platform can be active at a time.

Usage Limits & Plans

Feature	Free	Pro ($12/mo)	Team ($8/user/mo)
Tickets	20/month	50/day	Unlimited
AI Model	Standard	Enhanced	Enhanced
Integrations	Clipboard only	Jira + Linear + GitHub + Notion	All + GitHub Issues
Custom templates	--	Yes	Yes + shared
Ticket history	Last 5	Unlimited	Unlimited + team
Support	Community	Email	Priority + Slack

Your current usage is always visible in the extension footer. The counter shows tickets used today (or this month for free tier) and your limit.

Keyboard Shortcuts

You can quickly access SpekAI using Chrome's extension shortcuts:

1. Go to chrome://extensions/shortcuts in your browser.
2. Find SpekAI and set your preferred keyboard shortcut (e.g., Ctrl+Shift+S or Cmd+Shift+S).
3. Now you can highlight text and press the shortcut to open SpekAI instantly.

Troubleshooting

No text captured when I open SpekAI

Make sure you have text selected on the page before clicking the extension icon. Some pages (like Chrome internal pages, the Chrome Web Store, or PDF viewers) may restrict extensions from reading selections.

Jira projects not loading

• Verify your Jira host is correct (e.g., yourcompany.atlassian.net, without https://).
• Make sure your email matches the one on your Atlassian account.
• Regenerate your API token and try again — tokens can expire or be revoked.

"Cannot reach" errors

This usually means the API endpoint is unreachable. Check your internet connection and make sure the service (Jira, Linear, GitHub, Notion) is not experiencing an outage.

Ticket creation fails

• Jira: Make sure the issue type (Story, Bug, etc.) exists in your project's scheme. Some projects may not have all types enabled.
• GitHub: Make sure your token has the repo scope and that the labels you're trying to apply exist in the repository (or auto-create is enabled).
• Notion: Make sure your integration has been invited to the database and the database ID is correct.

Disconnecting a platform

Go to Settings, select the platform, and click Disconnect. This clears all stored credentials for that platform from your browser.

FAQ

Is my data secure?

Yes. Integration credentials (API tokens) are stored locally in your browser's Chrome storage and never sent to SpekAI servers. The only data sent to our backend is the highlighted text for AI processing, which is not stored after the response is returned. See our Privacy Policy for details.

Can I edit a ticket after generating it?

Yes. Every field — title, description, acceptance criteria, edge cases, type, and priority — is editable inline before you send or copy it.

Does SpekAI work on any website?

SpekAI works on most websites. It cannot access text on Chrome internal pages (chrome://), the Chrome Web Store, or pages that block content scripts.

Can I use SpekAI without connecting a project tool?

Yes. You can always copy the generated ticket to your clipboard and paste it wherever you need, even on the free plan without any integrations connected.

What AI model does SpekAI use?

SpekAI uses Anthropic's Claude for ticket generation. The free plan includes standard AI generation. The Pro and Team plans use an enhanced AI model for higher quality output with better context understanding.

How do I cancel my subscription?

You can manage your subscription through the Stripe billing portal. Click "Upgrade" in the extension footer, then "Manage Subscription" to access billing settings. Your Pro access remains active until the end of the current billing period.

Still have questions?

Reach out at support@spekai.app and we'll get back to you.