Using the app
Settings
Press Settings at the bottom of the sidebar to open the Settings window. Pick a category on the left and its contents appear on the right. Close it with ✕, Escape, or a click outside the window.
General · appearance
- Categories The Settings categories. Press one to change what shows on the right.
- Theme Choose Light, Dark or System. System follows this device.
- Language Choose 한국어 or English. Changing it reloads the app right away, so save anything you are editing first.
- Build version The version of Vinc running now. Include it when you report a problem.
Reading · View
- Document pane width Sets the width of the pane documents open in, in px. Dragging the grip beside the View changes this value too.
- Open View display options Closes Settings and opens the View's display settings. Size, spread, labels and the legend are changed there.
What the view card holds is on The graph.
Account · storage
In the web app it shows the account you are signed in with and the space you are working in.
- Connect account The sample demo has no connected account. On the desktop, this button starts browser sign-in.
- Storage location The sample demo shows local storage state. It is not this device's actual folder or account.
In the desktop app this tab holds two more things.
- Where it's stored and Keep the graph on this device: off by default. When on, the graph lives only in a folder you pick and your account holds no copy. When turning it off you choose whether to move this device's graph to your account. More on Local mode.
- Connect account: your browser opens so you can sign in and approve. Nothing to copy or paste. Once connected, Disconnect removes the key from this device.
AI connections (desktop)
This is where you register AI assistants so they can read and write Vinc.
- MCP: register Claude Desktop, Claude Code, Cursor and Codex CLI one at a time with Connect, and take them off with Remove. Restart the host after registering and it reaches Vinc.
- Web assistants: Copy address copies the address to add to claude.ai or ChatGPT as a connector. It connects to the graph in your account, so you need an account.
- Command line: press Set up to use the
vinccommand in a terminal. The commands are on CLI.
How to hand work to an assistant is on Using AI.
Data
It has three tabs: Create, Import and Share. Create and Import are on Putting knowledge in, and Share is on Sharing.
GRAPH.md
Edit the file your assistant reads before it writes, and approve the vocabulary it proposes. It is on Edit GRAPH.md.
Advanced (desktop)
Change these only if you run your own engine or paste a key by hand.
- Workspace: the name of the space you are viewing. Switch it back after trying the sample.
- Account key (manual): after getting past the first sign-in screen, paste a key made at vincs.io/account in Settings > Advanced. This is not a way around a failed first sign-in. The key is stored only on this device, and the field is cleared after saving.
- Engine address and Connection secret: the app fills these in. Enter them only if you run the engine yourself.
The desktop app does not read VINC_API_KEY. That environment variable is for the CLI; setting it does not sign you in to the app. If 0.9.6 keeps waiting after browser sign-in, see the first sign-in guidance.
About
Shows the version of the build running now and where your graph lives. The web app and the desktop app's account mode use your account graph; local mode uses the graph on this device.