Skip to content

Add agent deep links documentation#1522

Open
MikeCarbone wants to merge 3 commits into
mainfrom
cursor/agent-deep-links-docs-012c
Open

Add agent deep links documentation#1522
MikeCarbone wants to merge 3 commits into
mainfrom
cursor/agent-deep-links-docs-012c

Conversation

@MikeCarbone

Copy link
Copy Markdown
Member

Description

This PR adds a new documentation page under "Developer tools" for agent deep links. The page explains how to kick off agents in the Knock dashboard directly from a URL.

The documentation covers:

  • How agent deep links work
  • Choosing an account (using ~ shorthand or specific account slug)
  • Pre-filling prompts without auto-submitting
  • Parameters (q and autoSubmit)
  • Examples of deep link usage

Screenshots

Agent deep links documentation page

To show artifacts inline, enable in settings.

Linear Issue: KNO-14035

Open in Web Open in Cursor 

Co-authored-by: Mike Carbone <MikeCarbone@users.noreply.github.com>
@linear-code

linear-code Bot commented Jul 6, 2026

Copy link
Copy Markdown

KNO-14035

@vercel

vercel Bot commented Jul 6, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, Comment Jul 6, 2026 7:24pm

Request Review

Co-authored-by: Mike Carbone <MikeCarbone@users.noreply.github.com>
@MikeCarbone MikeCarbone marked this pull request as ready for review July 6, 2026 19:15

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Risk MEDIUM: Adds a new documentation page for agent deep links under developer tools, with a corresponding sidebar navigation entry.

Reasons

  • A new MDX page (content/developer-tools/agent-deep-links.mdx) is added, which introduces a new route to the documentation site
  • The sidebar navigation file (data/sidebars/developerToolsSidebar.ts) is modified to include the new page
  • No code, component, or configuration files are touched, keeping risk below HIGH
  • The diff is small (74 additions, 0 deletions) and limited to a single documentation section
  • The content is well-structured and follows existing documentation patterns

Notes

  • Verify the new sidebar entry renders correctly and the page is accessible at /developer-tools/agent-deep-links
  • Check that the external dashboard links (dashboard.knock.app) are valid and resolve correctly
  • Confirm the page ordering in the sidebar is intentional (appended at the end of the developer tools section)
Open in Web View Automation 

Sent by Cursor Automation: Docs PR classifier


There are two ways to address the account in a deep link:

### The `~` shorthand (recommended)

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@cursor remove "recommended"

@cursor cursor Bot Jul 6, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done! I've removed "(recommended)" from the heading. The line now reads:

### The `~` shorthand

The change has been committed and pushed to the PR.

Open in Web Open in Cursor 

Co-authored-by: Mike Carbone <MikeCarbone@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants