# Connect

Choose which wiki this session uses, the team project's pages on the Nimbalyst server...

- Repository: https://github.com/nimbalyst/nimbalyst (2013 stars)
- Category: Writing
- License: MIT
- Last updated: 2026-10-31
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add nimbalyst/nimbalyst --skill connect -g -a claude-code -y`
Codex: `npx skills add nimbalyst/nimbalyst --skill connect -g -a codex -y`
Cursor: `npx skills add nimbalyst/nimbalyst --skill connect -g -a cursor -y`
Gemini CLI: `npx skills add nimbalyst/nimbalyst --skill connect -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add nimbalyst/nimbalyst`

## Description

Choose which wiki this session uses, the team project's pages on the Nimbalyst server or the project's local wiki of files, and connect a repository to its team project. Use at the start of a task before any wiki tool, when a wiki tool returns repo_not_bound, ambiguous_project, pin_mismatch, project_not_accessible, admin_required or "No local wiki", or when the user asks to connect a repository or start a wiki. How to write pages is in the update skill.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Connect to the wiki

This skill only decides which wiki the session uses and, for a team wiki, connects the repository to its project. What to write, and how, is in the `update` skill; types and the guide page are in `setup`.

## Nimbalyst desktop comes first

If the desktop app's wiki tools are available (`mcp__nimbalyst-trackers__*`, or `listPages` from a server whose name contains neither `nimbalyst-team` nor `nimbalyst-local`), you are running inside Nimbalyst, which already reaches the same pages, team and local. Use those tools and do not call this plugin's tools in this session: two write paths into the same pages produce duplicates.

## Two wikis, two servers

This plugin has two wiki servers with the same tool names (`listPages`, `readCollabDoc`, `applyCollabDocEdit`, `createSharedDoc` and the rest):

- **`nimbalyst-team`**: the team project's pages on the Nimbalyst server. It comes in the `nimbalyst-wiki-team` add-on plugin, which the `team` skill installs. Needs a Nimbalyst sign-in and a repository connected to a team project. Every call takes `repo` and, when pinned, `project`.
- **`nimbalyst-local`**: the project's local wiki, a folder of markdown files in the repository (default `nimbalyst-local/wiki`, kept out of git; or a checked-in folder such as `docs/wiki`). No account, no `repo` or `project` arguments. `initLocalWiki` creates it. The Nimbalyst app, `nim` and any editor read the same files.

Decide once per session which one you use, then call only that server's tools for wiki work. Never write the same thing to both. Team data never goes through `nimbalyst-local`: it refuses team uris, console links and team issue keys and names the tool to use on `nimbalyst-team`.

The rest: https://github.com/nimbalyst/nimbalyst/blob/HEAD/plugins/nimbalyst-wiki/skills/connect/SKILL.md