Features
Idea Capture & Management

Idea Capture & Management

Ideas are the entry point to the content pipeline: a lightweight, quickly-captured record that gets triaged and — when it's ready — turned into a full LinkedIn post draft.

This page covers the user-facing idea capture and management feature. For the wire-level contract, see API Reference → Ideas and MCP → Ideas Tools. The authoritative spec is specs/features/ideas.md in the repo.

What you can do

  • Capture instantly. The Quick-add bar at the top of the Ideas page takes a single block of free text — no separate title field. Press Enter to save, Shift+Enter for a new line.
  • Let AI title it for you. Whatever you type becomes the idea's description; an AI model (Amazon Bedrock) reads it and generates a short, punchy title automatically.
  • Filter by status. The status dropdown on the Ideas page narrows the list to New or Converted (or All statuses).
  • Edit. Open an idea's edit dialog to revise its title or description.
  • Generate a post. Click the lightning-bolt action on any New idea to open the Generate Post dialog — pick a prompt template, audience, tone, language, and length, then generate a draft. This is the one path that moves an idea to Converted.
  • Delete. Any idea — including one already Converted — can be deleted.
  • Capture from outside the app. A token-based Quick Capture endpoint powers the bookmarklet, Raycast, and other automation entry points without a full login session. See Capturing Ideas.

AI title generation

This is the single most important behavior to understand about idea creation: the "title" you type is not the title that gets saved.

When you create an idea through the app (or Quick Capture), the text you type is sent to the backend as raw content. The backend calls Bedrock to generate a short, 3-4 word title from it, then stores:

  • your original text as description
  • the AI-generated text as title
you type:  "Just realized our onboarding flow loses 40% of users at step 3 —
            thinking about writing up what we changed to fix it"

                              ▼  Bedrock: generate_idea_title(content)

title  ──▶ "Fixing Onboarding Drop-off"
description ──▶ (your original text, verbatim)

This is why the Quick-add placeholder reads "Describe your idea... AI will generate a short title." — you're never expected to write a title yourself.

⚠️

This title-generation step only happens for ideas created through the web app or Quick Capture. Ideas created through the MCP create_idea tool use whatever title the caller supplies literally — no Bedrock call. See MCP → Ideas Tools.

Idea lifecycle

An idea has exactly two states:

StatusMeaning
newCaptured, not yet converted into a post
convertedA post has been generated from this idea

The only allowed transition is new → converted, and it happens in one of two ways:

  1. You generate a post from it — clicking "Generate Post" and completing the generation flow converts the idea as a side effect of creating the post. This is the normal path; the app never exposes a manual "mark as converted" control.
  2. A direct API call to PUT /api/ideas/{id}/status — available to API/automation clients, not exposed anywhere in the UI.

There's no way back from converted to new, and no other status exists (an earlier product design sketched out triaged, in_progress, archived, and a priority field — none of that made it into the shipped implementation).

⚠️

Deleting an idea has no status restriction: a converted idea (one that already has a post generated from it) can still be deleted. Deleting the idea does not touch or delete the post that was generated from it.

Fields

FieldDescription
TitleAI-generated (or literal, via MCP) short display title
DescriptionThe free-text content you captured
TagsFreeform labels, used to filter your idea list and to prioritize matching example posts when generating a draft
Source URLAn optional reference link
Statusnew or converted
AuthorWhoever captured the idea

Where ideas come from

Entry pointHowNotes
Quick-add barIn-app, Ideas pageAI title generation applies
Edit dialogIn-app, Ideas pageEdits an existing idea's title/description
Quick CaptureToken-authenticated URL or API, no loginSame AI title generation, tagged as a different capture source in metrics
MCP create_idea toolAI agent / automation clientLiteral title, no AI generation — see MCP → Ideas Tools

Known gap

The Ideas page ships a multi-select checkbox / "bulk delete" code path in the component tree, but no control in the UI ever populates a selection — it's inert, carried over from an unfinished feature. There is currently no bulk-action capability in the shipped product.

See also