AI Assistant Integration

A collection of skills and prompts for automating logi RP integration in AI coding assistants like Claude Code, Cursor, and Codex. This page is updated continuously.

For external developers

The skills and prompts listed on this page are generalized versions that you can apply directly to your own RP environment. The logi IdP itself runs live at https://api.1pass.dev, so you don't need to host it yourself, and you register your RP through the logi CLI or the developer console.

If you'd like to see how the integration modes (OAuth / QR / App Clip / macOS) work first, browse the scenario catalog at demo.1pass.dev.

llms.txt — a standard endpoint for any AI agent

There is an endpoint that delivers all of logi's developer docs at once as LLM-friendly markdown. It follows the llmstxt.org standard, converts VitePress-specific syntax (like :::tip) into standard markdown admonitions, and rewrites site-relative links to absolute URLs, so any LLM can read it directly without extra interpretation.

Endpoint	Purpose	Size
https://docs.1pass.dev/llms.txt	Topic index + one-line summaries + usage guide	~11 KB
https://docs.1pass.dev/llms-full.txt	The entire docs bundled into one file	~280 KB
https://docs.1pass.dev/llms/<path>.md	Per-topic splits (e.g. llms/guide/registering-apps.md)	~6 KB average

How do I use it?

Small-context models / when you already know the exact topic — use the index to find where the topic lives, then fetch just that file:

curl https://docs.1pass.dev/llms.txt | grep -i "registering"
curl https://docs.1pass.dev/llms/guide/registering-apps.md

Long-context models / when you want to see everything at once — grab the whole bundle:

curl https://docs.1pass.dev/llms-full.txt

Reading it directly in Claude Code

When you start a logi integration task within a session, add this one line to your prompt:

"Before integrating logi, read https://docs.1pass.dev/llms-full.txt first and then get started."

Claude Code's WebFetch tool fetches the markdown as-is and loads it into context. The existing logi-rp-integrate skill uses this endpoint internally to reference the latest guide.

In Cursor / Continue / Aider

Most assistants can't fetch external URLs directly, so instead:

1. Save it locally with curl https://docs.1pass.dev/llms-full.txt > .cursor/logi-docs.md.
2. Add it under Cursor settings → "Documentation," or index it with Continue's @docs.
3. Then invoke it in natural language, like "add the RP following the logi registration guide" → the model references the indexed docs.

INFO

The bundle is regenerated automatically on every docs build. Caching it for more than 6 hours may reference a stale guide, so we recommend re-downloading it periodically in CI.

Claude Code skills

logi-rp-integrate — 5-minute RP integration automation

Completes the standard procedure for attaching logi SSO as an RP to an existing Rails / Flutter / Next.js / iOS project in a single skill invocation. Seven steps: automatic tech-stack detection → standard controller/service drop-in → RP registration on the logi server → deploy-platform env injection → live verification.

When it triggers

• Requests like "add logi login" / "integrate 1pass" / "register a logi RP" / "add logi SSO"
• Applying it across multiple projects ("apply it elsewhere too," "apply it across the projects")

Key command preview (extracted from the skill body)

# 1. Register the RP (CLI recommended — an SSH fallback exists too)
logi apps create \
  --name "$PROJECT" \
  --redirect-uri "$SERVICE_URL/auth/logi/callback" \
  --scope "openid profile:basic email"

# 2. Inject the four deploy-platform env vars (Render example)
#    LOGI_API_URL / LOGI_CLIENT_ID / LOGI_CLIENT_SECRET / LOGI_SCOPES

# 3. Post-deploy host check (a frequently skipped step)
curl -sI "$SERVICE_URL/auth/logi/start" | grep -i "^location:" \
  | grep -q "api.1pass.dev" && echo "✓ env OK"

Installation / registration

1. Add the skill file to your Claude Code skills directory.

   mkdir -p ~/.claude/skills/logi-rp-integrate
   curl -fsSL https://docs.1pass.dev/skills/logi-rp-integrate/SKILL.md \
     -o ~/.claude/skills/logi-rp-integrate/SKILL.md

2. Sign in to your logi account (logi login).
3. Invoke it in a Claude Code session with natural language like "register a logi RP," and it triggers automatically.

Per-environment settings

The skill detects the following values automatically or asks for them via prompts. Knowing them in advance speeds up the work.

Item	Description	Example
logi API endpoint	Used for RP registration and OIDC verification	https://api.1pass.dev (default, no change needed)
RP service domain	Your app's prod URL — used to auto-generate the redirect_uri	https://app.example.com
Deploy platform	Branches the env-injection method automatically	Render / Vercel / Fly / Heroku / self-hosted
env prefix	Codebase convention	LOGI_* (recommended)
logi account	The account signed in via logi login	Your logi developer account

Cursor rules

None yet. Coming soon.

Other assistants (Codex / Aider / Continue / ...)

None yet. Coming soon.

Contributing

A channel for registering your own assistant skills, prompts, and rules is in preparation.

---

Related docs

• Quickstart — 5-minute integration (manual)
• Rails integration — code-level guide
• Troubleshooting — 7 failure scenarios + env-check checklist