diff --git a/packages/kilo-docs/lib/nav/kiloclaw.ts b/packages/kilo-docs/lib/nav/kiloclaw.ts index 5d051fb7255..d7bed669f1f 100644 --- a/packages/kilo-docs/lib/nav/kiloclaw.ts +++ b/packages/kilo-docs/lib/nav/kiloclaw.ts @@ -30,11 +30,17 @@ export const KiloClawNav: NavSection[] = [ }, { href: "/kiloclaw/development-tools", - children: "Development Tools", + children: "Integrations", subLinks: [ { href: "/kiloclaw/development-tools", children: "Overview" }, { href: "/kiloclaw/development-tools/github", children: "GitHub" }, { href: "/kiloclaw/development-tools/google", children: "Google Workspace" }, + { href: "/kiloclaw/development-tools/linear", children: "Linear" }, + { href: "/kiloclaw/development-tools/composio", children: "Composio" }, + { href: "/kiloclaw/tools/1password", children: "1Password" }, + { href: "/kiloclaw/tools/brave-search", children: "Brave Search" }, + { href: "/kiloclaw/tools/agentcard", children: "AgentCard" }, + { href: "/kiloclaw/tools/other-tools", children: "Other Tools" }, ], }, { @@ -46,17 +52,6 @@ export const KiloClawNav: NavSection[] = [ { href: "/kiloclaw/triggers/scheduled", children: "Scheduled" }, ], }, - { - href: "/kiloclaw/tools", - children: "Tools", - subLinks: [ - { href: "/kiloclaw/tools", children: "Overview" }, - { href: "/kiloclaw/tools/1password", children: "1Password" }, - { href: "/kiloclaw/tools/brave-search", children: "Brave Search" }, - { href: "/kiloclaw/tools/agentcard", children: "AgentCard" }, - { href: "/kiloclaw/tools/other-tools", children: "Other Tools" }, - ], - }, { href: "/kiloclaw/troubleshooting/common-questions", children: "Troubleshooting", diff --git a/packages/kilo-docs/pages/kiloclaw/development-tools/composio.md b/packages/kilo-docs/pages/kiloclaw/development-tools/composio.md new file mode 100644 index 00000000000..e3ac585a0dc --- /dev/null +++ b/packages/kilo-docs/pages/kiloclaw/development-tools/composio.md @@ -0,0 +1,66 @@ +--- +title: "Composio Integration" +description: "Connect Composio to your KiloClaw agent to access hundreds of tool integrations" +--- + +# Composio Integration + +Connect Composio to your KiloClaw agent to instantly unlock access to 250+ tool integrations — from Salesforce and HubSpot to Notion, Jira, and beyond. Composio is a platform that handles the authentication and connection details for each service, so your agent can use them without you having to set up each one individually. + +{% callout type="info" title="Tip" %} +Browse the full list of tools Composio supports at [composio.dev/tools](https://composio.dev/tools). If a tool you need is listed there, you can connect it to KiloClaw through Composio in minutes. +{% /callout %} + +## Prerequisites + +Before you begin, make sure you have: + +- A **Composio account** — sign up for free at [composio.dev](https://composio.dev) +- A **KiloClaw agent** already set up — see the [Dashboard Reference](/docs/kiloclaw/dashboard) if you haven't done this yet + +## Setup + +### Step 1: Create a Composio account and get your API key + +1. Go to [composio.dev](https://composio.dev) and sign up for a free account +2. Once logged in, open the **Settings** or **API Keys** section of your Composio dashboard +3. Click **Create API Key**, give it a name (for example, `kiloclaw`), and copy the key + +### Step 2: Add the API key to KiloClaw + +1. Go to the **Settings** tab on your [KiloClaw dashboard](/docs/kiloclaw/dashboard) +2. Scroll to the **Integrations** section and find **Composio** +3. Paste the API key into the **Composio API Key** field +4. Click **Save** +5. **Redeploy** your instance to apply the changes + +### Step 3: Authenticate tools in Composio + +Composio acts as a bridge between KiloClaw and each third-party service. To allow your agent to use a specific tool, you need to authorise it once inside Composio: + +1. In your Composio dashboard, go to **Integrations** or **Connected Accounts** +2. Find the tool you want (for example, Slack, Notion, or Jira) +3. Click **Connect** and follow the authentication steps for that service +4. Once connected, the tool is immediately available to your KiloClaw agent + +Repeat this for each service your agent needs to access. + +## What Your Agent Can Do + +Once connected, your KiloClaw agent can use any tool you have authenticated in Composio. With 250+ integrations available, this includes: + +| Category | Example tools | +|---|---| +| **Project management** | Jira, Notion, Asana, Trello, ClickUp | +| **Communication** | Slack, Discord, Microsoft Teams | +| **Development** | GitHub, GitLab, Bitbucket | +| **CRM & sales** | Salesforce, HubSpot, Pipedrive | +| **Documents & storage** | Google Drive, Dropbox, Confluence | +| **Databases** | Airtable, Supabase, PostgreSQL | + +Your agent can perform actions like reading data, creating records, sending messages, and triggering workflows — all through natural language prompts. + +## Related + +- [Integrations Overview](/docs/kiloclaw/development-tools) +- [GitHub Integration](/docs/kiloclaw/development-tools/github) diff --git a/packages/kilo-docs/pages/kiloclaw/development-tools/index.md b/packages/kilo-docs/pages/kiloclaw/development-tools/index.md index a99a3d705de..97e513d8048 100644 --- a/packages/kilo-docs/pages/kiloclaw/development-tools/index.md +++ b/packages/kilo-docs/pages/kiloclaw/development-tools/index.md @@ -1,13 +1,19 @@ --- -title: "Development Tools" -description: "Connect your KiloClaw agent to development platforms like GitHub and Google Workspace" +title: "Integrations" +description: "Manage integrations and settings for your KiloClaw agent" --- -# Development Tools +# Integrations -KiloClaw supports integrations with popular development platforms, allowing your agent to interact with repositories, code reviews, calendars, documents, and more — all autonomously. +Configure integrations and settings for your KiloClaw agent. Connect third-party services to give your agent access to repositories, issue trackers, calendars, documents, and hundreds of other tools — all without manual intervention. ## Available Integrations - [**GitHub**](/docs/kiloclaw/development-tools/github) — Clone repositories, push commits, open pull requests, and leave code reviews. - [**Google Workspace**](/docs/kiloclaw/development-tools/google) — Access Gmail, Calendar, Drive, Docs, Sheets, Slides, Tasks, and more. +- [**Linear**](/docs/kiloclaw/development-tools/linear) — Create and update issues, read projects, and track work in Linear. +- [**Composio**](/docs/kiloclaw/development-tools/composio) — Access 250+ tool integrations through a single connection. +- [**1Password**](/docs/kiloclaw/tools/1password) — Securely manage credentials and let your agent fetch API keys or passwords without ever seeing them in plain text. +- [**Brave Search**](/docs/kiloclaw/tools/brave-search) — Equip your agent with real-time web browsing via the Brave Search API. +- [**AgentCard**](/docs/kiloclaw/tools/agentcard) — Enable your agent to perform financial transactions using virtual debit cards. +- [**Setting Up Other Tools**](/docs/kiloclaw/tools/other-tools) — Configure your agent to use any third-party tool with a CLI or API. diff --git a/packages/kilo-docs/pages/kiloclaw/development-tools/linear.md b/packages/kilo-docs/pages/kiloclaw/development-tools/linear.md new file mode 100644 index 00000000000..3d12a39fb36 --- /dev/null +++ b/packages/kilo-docs/pages/kiloclaw/development-tools/linear.md @@ -0,0 +1,64 @@ +--- +title: "Linear Integration" +description: "Connect Linear to your KiloClaw agent to create and manage issues automatically" +--- + +# Linear Integration + +Connect Linear to your KiloClaw agent so it can create issues, update their status, read project backlogs, and track work — all automatically. Linear is a project management tool popular with software teams for planning and tracking features, bugs, and tasks. + +{% callout type="warning" title="Keep your API key private" %} +Your Linear API key grants access to your workspace. Never share it publicly or commit it to a repository. If a key is ever exposed, revoke it immediately from your Linear account settings and generate a new one. +{% /callout %} + +## Prerequisites + +Before you begin, make sure you have: + +- A **Linear account** with access to the workspace you want KiloClaw to use +- A **KiloClaw agent** already set up — see the [Dashboard Reference](/docs/kiloclaw/dashboard) if you haven't done this yet + +## Setup + +### Step 1: Generate a Linear API key + +1. Log in to your Linear account at [linear.app](https://linear.app) +2. Click your workspace name in the top-left corner and select **Settings** +3. In the left sidebar, go to **Account** → **API** +4. Click **Create key** +5. Give the key a descriptive label (for example, `kiloclaw-bot`) and click **Create** +6. Copy the key — you will only see it once + +### Step 2: Add the API key to KiloClaw + +1. Go to the **Settings** tab on your [KiloClaw dashboard](/docs/kiloclaw/dashboard) +2. Scroll to the **Integrations** section and find **Linear** +3. Paste the API key into the **Linear API Key** field +4. Click **Save** +5. **Redeploy** your instance to apply the changes + +### Step 3: Verify the connection + +Once your instance has redeployed, send your agent a prompt to check that Linear is working. For example: + +- "List the open issues assigned to me in Linear" +- "What projects are in my Linear workspace?" + +If the agent returns results from your workspace, the connection is working correctly. + +## What Your Agent Can Do + +Once connected, your KiloClaw agent can interact with Linear on your behalf: + +| Action | Example prompt | +|---|---| +| Create an issue | "Create a Linear issue titled 'Fix login bug' in the Engineering project" | +| Update an issue | "Mark the Linear issue LIN-42 as In Progress" | +| Read issues | "Show me all open bugs assigned to the team this week" | +| Search projects | "What issues are in the Backend project?" | +| Add comments | "Add a comment to LIN-100 saying the fix has been deployed" | + +## Related + +- [Integrations Overview](/docs/kiloclaw/development-tools) +- [GitHub Integration](/docs/kiloclaw/development-tools/github) diff --git a/packages/kilo-docs/previous-docs-redirects.js b/packages/kilo-docs/previous-docs-redirects.js index 5da3b5d9837..e9bb1472ce8 100644 --- a/packages/kilo-docs/previous-docs-redirects.js +++ b/packages/kilo-docs/previous-docs-redirects.js @@ -1,4 +1,10 @@ module.exports = [ + { + source: "/docs/kiloclaw/tools", + destination: "/docs/kiloclaw/development-tools", + basePath: false, + permanent: true, + }, { source: "/docs/contributing/cline-to-kilo-migration", destination: "/docs/contributing",