Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content

Your First Search

A step-by-step walkthrough of using Gateway to search across your connected tools.

Prerequisites

  • At least one provider connected (Linear, Notion, or Slack)
  • Gateway installed in your AI editor (Installation)

Step 1: See What's Connected

Start by asking what you can do:

You: 
What can I do with Gateway?
AI responds:

You have 3 providers connected:

  • Linear — issues, sprints, projects, comments, teams
  • Notion — pages, databases, search, comments
  • Slack — messages, channels, threads, reactions, search

You can search across all of them, create and update items, send messages, and more. What would you like to do?

Step 2: Search for Something

Ask for what you need in plain language:

You: 
Find all Linear issues about the authentication bug
AI responds:

Found 3 issues matching "authentication bug":

  1. [ENG-142] Auth timeout on login page — In Progress, assigned to Sarah
  2. [ENG-156] OAuth token refresh failing — Backlog, unassigned
  3. [ENG-89] Fix session expiry handling — Done (completed Mar 10)

Would you like to open any of these, or take action on them?

Step 3: Take Action on Results

You can act on what you found right away:

You: 
Assign ENG-156 to me and add a comment that I'm looking into it
AI responds:

Done! I've:

  • ✅ Assigned ENG-156 "OAuth token refresh failing" to you
  • ✅ Added comment: "Looking into this now."

The issue is now in your backlog. Want me to move it to In Progress?

Step 4: Search Across Tools

The real power is working across multiple tools at once:

You: 
Find the Q1 planning doc in Notion and any related Linear issues
AI responds:

Notion — found 2 pages:

  • 📄 Q1 2026 Planning (last edited 2 days ago)
  • 📄 Q1 OKR Tracker (last edited today)

Linear — found 5 related issues:

  • [PROD-88] Q1 roadmap: auth migration — In Progress
  • [PROD-91] Q1 roadmap: API v2 — Backlog
  • [PROD-93] Q1 planning: resource allocation — Done
  • [ENG-160] Q1 infra budget review — In Review
  • [MKT-45] Q1 launch prep — In Progress

The planning doc mentions the auth migration and API v2 as top priorities. Want me to summarize the doc or update any issues?

Tips

  • Be specific — "Find Linear issues assigned to me in the current sprint" works better than "show my tasks"
  • Chain actions — "Create the issue, then post it in #engineering" works in one go
  • Use provider names — "Search Notion for..." is more direct than "search my documents for..."
  • Ask what's possible — "What can I do with Slack channels?" shows you everything available