Metadata-Version: 2.4
Name: suggestionbox-connect
Version: 2.0.0
Summary: Connect your terminal and AI assistant to your private SuggestionBox.io Inbox.
Author: KnowledgeTack LLC
License-Expression: LicenseRef-Proprietary
Project-URL: Homepage, https://suggestionbox.io/
Project-URL: Changelog, https://pypi.org/project/suggestionbox-connect/#history
Project-URL: Terms, https://suggestionbox.io/terms/
Project-URL: Support, https://suggestionbox.io/terms/#contact
Keywords: suggestionbox,suggestions,cli,mcp,ai,product-management
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Office/Business
Classifier: Topic :: Utilities
Requires-Python: <3.15,>=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: keyring<26,>=25
Dynamic: license-file

# SuggestionBox Connect

Connect your terminal and AI assistant to your private SuggestionBox.io Inbox.
One installation provides the `sb` command-line tool and the
`suggestionbox-mcp` AI-assistant connector.

## Install

Install SuggestionBox Connect in an isolated environment with
[pipx](https://pipx.pypa.io/):

```bash
pipx install suggestionbox-connect
```

SuggestionBox supports Python 3.10 through 3.14 on Linux, macOS, and Windows.

## Connect

1. Sign in to SuggestionBox.io and open **Inbox → Inbox settings**.
2. In **Command line**, create a credential for this computer and copy it.
3. Run:

```bash
sb connect
```

Paste the credential into the hidden prompt. The CLI verifies it before saving
it in your operating system's credential store and names the exact
SuggestionBox it belongs to. The credential can add private
Inbox items only; it cannot read your Inbox or publish suggestions.

Confirm the connection at any time:

```bash
sb status
```

## Add to Inbox

Use a title, a body, or both:

```bash
sb add --title "Remember Inbox filters between visits"
sb add --body "Show which CSV column failed validation."
sb add --title "Scheduled exports" --body "Allow a weekly delivery schedule."
```

Pipe a longer body from another command:

```bash
printf '%s' "Add a dry-run option" | sb add --body -
```

Use `--received` when recording something that came from another person:

```bash
sb add --received --title "Customer requested a printable invoice"
```

Every successful command prints the private Inbox item ID and its owner-only
review URL.

## Disconnect, upgrade, or uninstall

```bash
sb disconnect
pipx upgrade suggestionbox-connect
pipx uninstall suggestionbox-connect
```

Deleting the credential in Inbox settings immediately prevents later use from
this computer. `sb disconnect` removes the local copy but does not delete the
server-side credential.

## Automation

For ephemeral automation, supply `SUGGESTIONBOX_INBOX_TOKEN` through the
automation platform's secret store. Do not put an Inbox credential in a command,
URL, project file, prompt, or log.

## AI-assistant tool

The same distribution includes the add-only `suggestionbox-mcp` STDIO
server. Create and copy a separate **AI assistant** credential for each
assistant, then run the matching command:

```bash
sb connect codex
sb connect claude
```

Each command verifies and securely saves the credential, installs the MCP
server in that assistant, and handles operating-system details internally.
Start a new assistant session afterward. The MCP server cannot read or publish
suggestions and acts only when the assistant invokes its single `add_to_inbox`
tool.

Check or remove either connection with:

```bash
sb status codex
sb disconnect codex
sb status claude
sb disconnect claude
```

Use of this client and SuggestionBox.io is governed by the
[SuggestionBox.io Terms of Service](https://suggestionbox.io/terms/). For help,
contact [support@suggestionbox.io](mailto:support@suggestionbox.io).
