Files

T

History

rune 017a0dbd9d Parse a pasted JSON args array correctly instead of mangling each token

Real incident: pasting gethomepage.dev's example args array (JSON,
quotes/commas/brackets and all) into the plain "Arguments" field
produced tokens like "mcp-remote," with the comma baked in, which
crashed npx with EINVALIDTAGNAME on the literal package name
"mcp-remote,". The existing char-by-char tokenizer treats quote
characters as its own quoting mechanism and consumes them, so a JSON
array's per-item quotes never get stripped and commas outside them
become part of the token.

parseArguments now tries decoding a well-formed JSON array of strings
first (only when the whole trimmed input is bracket-wrapped valid
JSON), falling back to the original shell-style tokenizer otherwise —
so pasting a server's args straight from its JSON config now works.
Tooltip and help doc updated; a partial paste (e.g. missing the opening
bracket) still isn't valid JSON and falls back as before, documented as
a known limitation rather than silently guessed at.

2026-08-26 14:26:45 +02:00

Contents

Parse a pasted JSON args array correctly instead of mangling each token

2026-08-26 14:26:45 +02:00

README.md

Rename app from oAI to Confab

2026-08-02 14:58:14 +02:00

README.md

Confab Help Book

This folder contains the Apple Help Book for Confab.

Adding to Xcode Project

Add the help folder to your project:
- In Xcode, right-click on the Resources folder in the Project Navigator
- Select "Add Files to 'Confab'..."
- Select the Confab.help folder
- Important: Check "Create folder references" (NOT "Create groups")
- Click "Add"
Configure the help book in build settings:
- Select your Confab target in Xcode
- Go to the "Info" tab
- Add a new key: CFBundleHelpBookName with value: Confab Help
- Add another key: CFBundleHelpBookFolder with value: Confab.help
Build and test:
- Build the app (⌘B)
- Run the app (⌘R)
- Press ⌘? or select Help → Confab Help to open the help

Structure

Confab.help/
├── Contents/
│   ├── Info.plist              # Help book metadata
│   └── Resources/
│       └── en.lproj/
│           ├── index.html      # Main help page
│           └── styles.css      # Stylesheet
└── README.md                   # This file

Features

✅ Comprehensive coverage of all Confab features
✅ Searchable via macOS Help menu search
✅ Dark mode support
✅ Organized by topic with table of contents
✅ Keyboard shortcuts reference
✅ Command reference with examples
✅ Follows Apple Human Interface Guidelines

Customization

To update the help content:

Edit Contents/Resources/en.lproj/index.html
Update styles in Contents/Resources/en.lproj/styles.css
Rebuild the app

Troubleshooting

If help doesn't open:

Make sure you added the folder as a "folder reference" (blue folder icon in Xcode)
Check that CFBundleHelpBookName and CFBundleHelpBookFolder are set in Info
Clean build folder (⇧⌘K) and rebuild

Adding More Pages

To add additional help pages:

Create new HTML files in Contents/Resources/en.lproj/
Link to them from index.html

Include proper meta tags for searchability:

<meta name="AppleTitle" content="Page Title">
<meta name="keywords" content="keyword1, keyword2">