#!/usr/bin/env bash
# InfoLobby AI Agent Skill installer - https://infolobby.com/skill
set -e
BASE="https://infolobby.com/skill/files"
DIR="${CLAUDE_SKILLS_DIR:-$HOME/.claude/skills}/infolobby"
mkdir -p "$DIR/references"
curl -fsSL "$BASE/SKILL.md"                -o "$DIR/SKILL.md"
curl -fsSL "$BASE/references/endpoints.md" -o "$DIR/references/endpoints.md"
curl -fsSL "$BASE/references/fields.md"    -o "$DIR/references/fields.md"
echo "InfoLobby skill installed at $DIR"

# InfoLobby AI Agent Skill installer - https://infolobby.com/skill
$ErrorActionPreference = "Stop"
$Base = "https://infolobby.com/skill/files"
$Root = if ($env:CLAUDE_SKILLS_DIR) { $env:CLAUDE_SKILLS_DIR } else { Join-Path $HOME ".claude\skills" }
$Dir  = Join-Path $Root "infolobby"
New-Item -ItemType Directory -Force (Join-Path $Dir "references") | Out-Null
Invoke-WebRequest -UseBasicParsing -Uri "$Base/SKILL.md"                -OutFile (Join-Path $Dir "SKILL.md")
Invoke-WebRequest -UseBasicParsing -Uri "$Base/references/endpoints.md" -OutFile (Join-Path $Dir "references\endpoints.md")
Invoke-WebRequest -UseBasicParsing -Uri "$Base/references/fields.md"    -OutFile (Join-Path $Dir "references\fields.md")
Write-Host "InfoLobby skill installed at $Dir"

InfoLobby AI Agent Skill

A drop-in Agent Skill that lets any compatible AI agent — Claude Code, Cursor, Gemini CLI, Goose, OpenCode, and many others — read and write your InfoLobby data through the public API.

You install one folder. The agent loads it on demand. The first time the agent runs it, it asks for your InfoLobby API key once and caches it locally. From then on you can say things like "add a new lead for Acme with email hello@acme.test" and have it work.

What it lets the agent do

• Discover your data — list workspaces, list tables, fetch a table's field schema so writes use the correct keys
• Query records — filter, search, sort, paginate; query through saved views for repeatable reports
• Create, update, delete records — partial updates, batch deletes
• Read and post comments — including with file attachments
• Manage record attachments — upload, download, delete files up to 50 MB

The skill is deliberately scoped to data work. It does not create or modify workspaces, change table schemas, manage members, or run flows. Those operations through an AI agent are easy to misuse; if you need them, use the full public API directly.

Example session

You: "List the open opportunities over $10k in my Sales workspace."

The agent (running the skill):

1. Reads ~/.infolobby/key for your token.
2. Calls GET /api/spaces/list, picks the one named Sales.
3. Calls GET /api/space/{id}/tables/list, picks Opportunities.
4. Calls GET /api/table/{id}/get to learn the field id slugs (status, amount, account, …).
5. POSTs to /api/table/{id}/records/query with a filter [{column: "amount", compare: ">", value: 10000}] plus a status filter.
6. Returns the table to you, complete with linked account names.

Every step happens in plain curl. No SDK, no daemon, no MCP server running in the background.

Install on macOS, Linux, or Windows

Use the tabbed installer at the top of this page. It downloads three files into your agent's skill directory:

~/.claude/skills/infolobby/
├── SKILL.md
└── references/
    ├── endpoints.md
    └── fields.md

For agents that look in a different location, set CLAUDE_SKILLS_DIR before piping the installer, or download the ZIP and copy the files where your agent expects them.

Inspect before you install

Piping a remote script into a shell is fast but worth checking. We make that easy:

• install.sh and install.ps1 are short — fewer than 20 lines each — and rendered in full below the installer.
• The ZIP and installer scripts have SHA256 hashes shown on the page. Compare against your downloaded copy with shasum -a 256 or Get-FileHash.
• The full source lives in the public GitHub mirror. git clone into your skills directory is a fine third install path.

How authentication works

The skill stores your InfoLobby API key in a single-line text file at ~/.infolobby/key. On the first call in a session the skill reads this file. If it does not exist, the skill asks you to paste your key, then writes it (with umask 077 on Unix, so only your user can read it).

Two key types work:

• Account key (il_live_…) — created in Account → API Keys. Account-owner only. Acts as the owner across whichever workspaces the key is scoped to.
• Personal key (il_user_…) — created in Profile → Personal API Keys. Acts as you, with your permissions. Use this if you do not own the account but want the agent to work as you would.

You can revoke either key at any time from the same screen — the skill will simply prompt for a new one on the next call. See the Authentication doc for the full lifecycle (rotate, reveal, IP allowlists, read-only flag).

What the skill won't do

By design:

• It does not create, modify, or delete workspaces.
• It does not create or modify table schemas.
• It does not manage workspace members or roles.
• It does not trigger flows, send emails, or modify webforms.
• It does not read or write billing or integrations.

For those, use the full REST API (account-level operations are gated behind an unrestricted account key and intentionally absent from the skill).

Troubleshooting

If your agent does the wrong thing in spite of correct API behaviour, open an issue on the GitHub mirror with the prompt and API response body.

Works with Claude Code and other Agent Skills clients

The skill is built for Claude Code first — the one-liner installs straight into ~/.claude/skills/infolobby/ and the agent loads it on demand. Because the Agent Skills format is an open standard, the same SKILL.md also works with Cursor, Gemini CLI, Claude.ai, Goose, OpenCode, OpenHands, Letta, and many other clients — drop the infolobby/ folder into whichever skills directory your agent uses, or point CLAUDE_SKILLS_DIR at it before running the installer.

Privacy and safety notes

• Your API key sits on your machine in plaintext at ~/.infolobby/key. On macOS and Linux the file is mode 0600. On Windows the default user-only ACL applies. If your host is compromised the key is gone; rotate it from Account → API Keys if you suspect that.
• The skill never echoes the key back to chat or includes it in command-history-visible arguments — it is read into a variable and sent only as a header.
• Account keys can be scoped to specific workspaces and made read-only at creation. For experimentation, create a read-only key against one workspace before granting broader access.