# Ways to Talk to Context Link

There are several ways to interact with Context Link. Each method suits different use cases and levels of integration.

---

## ChatGPT

Add the Context Link app connector or paste your link directly into chats.

### ChatGPT App Connector (Recommended)

Set up via the ChatGPT app connector for always-on access.

**Status:** Currently in beta, requires enabling developer mode.

**How to set up:**
1. Go to ChatGPT Settings > Apps and Connectors
2. Enable developer mode if not already enabled
3. Add Context Link as a connector using your subdomain
4. Ask ChatGPT to "get context on [topic]" and it searches your sources directly

**Advantage:** Works reliably without needing to switch modes.

### Via Direct Link

Paste your Context Link directly into any ChatGPT chat.

**Important:** When using via link, you'll need to set ChatGPT to **Thinking mode** or it won't visit Context Link. Unfortunately, Thinking mode isn't available in specific ChatGPT projects yet.

---

## Claude

Add Context Link as a skill in Claude so it's used automatically.

### Setup Steps

1. **Whitelist Context Link:**
   - Open the Claude app
   - Click Settings > Capabilities
   - In "Additional allowed domains", enter: `*.context-link.ai`

2. **Add the Skills:**
   - From the same Capabilities screen, go to Skills
   - Click "+ Add" and upload the skill files (download from your Context Link dashboard)

3. **Use it:**
   - Say "get context" or "use Context Link" in any Claude interaction
   - Claude will pull from your Context Link sources automatically

### Available Skills
- Downloadable from within Context Link's "Installation" screen.

| Skill | Purpose |
|-------|---------|
| **get_context** | Semantically search and fetch content from your connected sources |
| **save_memory** | Save new content to a Memory via POST request |
| **update_memory** | GET existing content, modify it, then POST it back |

### Via Direct Link

You can also paste your Context Link directly into any Claude chat without setting up skills.

---

## Via Direct Link (Any AI Tool)

Paste your Context Link into any AI chat to give it access to your knowledge base. Works with ChatGPT, Claude, Copilot, Gemini, Grok, and more.

### Getting Context

Add any word or phrase after the /slash (use dashes for multiple words):

```
yourname.context-link.ai/marketing
yourname.context-link.ai/june-2025-instagram-results
yourname.context-link.ai/annual-report-2025
yourname.context-link.ai/product-roadmap
```

The system runs a semantic search across all your connected sources and returns relevant snippets in clean markdown.

**Using modes:** Append `?mode=customer-support` (or `&mode=...` if using a PIN) to weight results toward a specific mode configured on your Connections page.

### Saving Memories

You can ask AI to save to your Context Link. The name of the Memory is determined by the /topic and can be retrieved later.

Example: "Save this brand voice summary to /brand-voice"

### Quick Access Tip

Consider setting up a text replacement on your device (e.g., typing `c-l` expands to your full Context Link URL with PIN). This makes it fast to paste your link into any conversation.

- [Guide for all devices](https://context-link.ai/blog/text-replacement-setup)
- Mac users: System Settings > Keyboard > Text Replacements

### Privacy (PIN)

Add a PIN to your link for extra security:
```
yourname.context-link.ai/topic?p=yourpin
```

You can change or remove your PIN from your Context Link dashboard.

---

## API

Use the Context Link API to integrate directly with your own applications or AI agents.

### Overview

Access your knowledge base programmatically using our REST API. Perfect for custom integrations, AI agents, or automated workflows.

### Subdomain API

Every user/organisation gets a subdomain (e.g., `acme.context-link.ai`).

**Endpoints:**
- `GET /<query>` — Run a semantic search across all connected sources (append `?mode=X` for mode-specific weightings)
- `POST /<namespace>` — Save content to a Memory (create)
- `PUT /<namespace>` — Update an existing Memory

**Content negotiation:** Returns different formats depending on the caller (ChatGPT-compatible JSON, Gemini format, or plain markdown).

### REST API v1

Structured JSON endpoint for programmatic access:
```
/api/v1/contexts?query=...
```

### Authentication

- **API key:** Pass via query param (`?api_key=...`) or header (`X-API-Key: ...`)
- **Optional PIN:** Extra security layer for sensitive content

### Rate Limits

5 requests per 10 seconds.

### Documentation

- **API Reference:** https://context-link.ai/docs/api-reference.md
- **Get your API key:** Available in your Context Link dashboard

### Share with Your AI

Give your AI assistant the API documentation so it understands how to use the Context Link API:

```
https://context-link.ai/docs/api-reference.md
```

---

## OpenAI Codex

Add Context Link as a skill in the [Codex](https://chatgpt.com/codex) app so it's used automatically.

Codex supports [custom skills](https://developers.openai.com/codex/skills/) — packaged instructions that extend what Codex can do. Context Link provides skill files that let Codex retrieve, save, and update your knowledge base.

### Setup Steps

1. **Download the skill files** from your Context Link dashboard (Installation page)
2. **Unzip and place each skill folder** into `~/.agents/skills/` (user-level) or your repo's `.agents/skills/` directory
3. **Use it:** Codex auto-detects installed skills. Say "get context" or reference your knowledge base, and Codex will pull from your Context Link sources. Skills can also be invoked implicitly when Codex determines they're relevant to your task.

### Available Skills

Downloadable from within Context Link's "Installation" screen.

| Skill | Purpose |
|-------|---------|
| **get_context** | Semantically search and fetch content from your connected sources |
| **save_memory** | Save new content to a Memory via POST request |
| **update_memory** | GET existing content, modify it, then POST it back |

### Skill File Locations

Codex scans these directories in order of priority:

- **Repository level:** `.agents/skills/` (from current directory up to repo root)
- **User level:** `~/.agents/skills/`
- **System level:** `/etc/codex/skills/`

Place your Context Link skills in whichever location suits your workflow — repo-level for project-specific use, or user-level for access across all projects.

---

## Summary Table

| Method | Best For | Notes |
|--------|----------|-------|
| ChatGPT App Connector | Always-on ChatGPT access | Beta, requires developer mode |
| ChatGPT via Link | Quick one-off queries | Requires Thinking mode |
| Claude Skills | Automatic Context Link usage in Claude | Requires whitelist + skill upload |
| Claude via Link | Quick one-off queries | Works without setup |
| Codex Skills | Automatic Context Link usage in Codex | Place skill folders in ~/.agents/skills/ |
| Direct Link (any AI) | Copilot, Gemini, Grok, etc. | Just paste and ask |
| API | Custom integrations, automations | Full programmatic access |

---

## Which Method Should I Use?

**For ChatGPT users:** Set up the App Connector for reliable, always-on access. If you just need occasional access, paste your link but remember to enable Thinking mode.

**For Claude users:** Set up the skills for the best experience. Claude will automatically use Context Link when you mention it. The skills also enable saving and updating Memories.

**For Codex users:** Download and install the skills into your `~/.agents/skills/` directory. Codex will automatically detect and use them when relevant.

**For other AI tools (Copilot, Gemini, Grok, etc.):** Use the direct link method—just paste your Context Link URL into the conversation.

**For developers and automations:** Use the API to integrate Context Link into scripts, workflows, or custom applications.

**For sharing with teammates:** Share your direct link (with or without PIN) so everyone can query the same knowledge base from their preferred AI tool.