53 lines
1.1 KiB
Markdown
53 lines
1.1 KiB
Markdown
# Mattermost Sync
|
|
|
|
This directory contains the workspace-local Mattermost extractor used by OpenCode to refresh communication context.
|
|
|
|
## Files
|
|
|
|
- `mattermost_context.py`
|
|
Extracts recent Mattermost messages as JSONL.
|
|
- `sync.sh`
|
|
Stable wrapper intended to be called by OpenCode.
|
|
- `.env.example`
|
|
Example configuration without secrets.
|
|
- `requirements.txt`
|
|
Reserved for future optional dependencies.
|
|
|
|
## Recommended Setup
|
|
|
|
1. Copy `.env.example` to `.env`.
|
|
2. Fill in your Mattermost values.
|
|
3. Create a local virtual environment if you want an isolated runtime.
|
|
|
|
Example:
|
|
|
|
```bash
|
|
cd scripts/mattermost
|
|
bash bootstrap.sh
|
|
```
|
|
|
|
## Usage
|
|
|
|
Manual run:
|
|
|
|
```bash
|
|
bash scripts/mattermost/sync.sh
|
|
```
|
|
|
|
OpenCode can use this script directly. If `FIDELITY_MATTERMOST_SYNC_CMD` is not set, the workspace plugins will fall back to this wrapper automatically.
|
|
|
|
## Bootstrap
|
|
|
|
You can initialize the local runtime with:
|
|
|
|
```bash
|
|
bash scripts/mattermost/bootstrap.sh
|
|
```
|
|
|
|
This will:
|
|
|
|
- create `.venv/` if missing
|
|
- create `.env` from `.env.example` if needed
|
|
|
|
The current extractor uses only the Python standard library, so no third-party install is required.
|