prismis

Prerequisites

• macOS or Linux
• Go 1.21+ for the TUI
• Python 3.13+ for the daemon
• LLM API key - OpenAI, Anthropic, Groq, or local Ollama
• Fabric (optional) - AI content analysis patterns with tab completion
• lspeak (optional) - Text-to-speech for audio briefings (uv tool install git+https://github.com/nickpending/lspeak.git)

Install everything (macOS/Linux)

make install

Upgrading from an older install? Bring config to current shape:

prismis-daemon migrate-config

Post-deploy smoke check (config valid, LLM services reachable, ≥1 source)

prismis-daemon verify

🔧 Installation

Install from Source

```bash git clone https://github.com/nickpending/prismis.git cd prismis make install

Build binaries

make build ```

🎬 Quick Start

```bash

🎮 Usage

Example: Let AI analyze your reading backlog

prismis-cli list --priority high --unread --json | llm "Summarize my reading queue" ```

Smoke-check that everything is wired up (config + LLM services + sources)

prismis-daemon verify

~/.config/prismis/config.toml

[api] host = "0.0.0.0" # Allow access from other devices (default: 127.0.0.1) ```

Note: Comment fetching increases LLM analysis costs. Configure max_comments in config.toml

prismis-cli source add reddit://programming

Idempotent config migration (after upgrading from older Prismis)

prismis-daemon migrate-config ```

Note: You can run the daemon however you prefer - in a tmux session, as a background process, or with any process manager you're comfortable with. It's just a regular Python program.

prismis-daemon verify is read-only and safe to run against a production daemon. It checks four things and exits 0 on all-pass / 1 on any failure: config validity, light LLM service reachable, deep LLM service reachable (or "not configured"), at least one active source.

Edit the .env file with your API keys

edit ~/.config/prismis/.env

Configuration

Prismis follows XDG standards: - Config: ~/.config/prismis/ - Data: ~/.local/share/prismis/ - Logs: Wherever you redirect them (stdout/stderr by default)

Security: API keys are stored in ~/.config/prismis/.env with 600 permissions (only you can read). Config references them with api_key = "env:VARIABLE_NAME" pattern for security.

LLM Configuration (Dual-Service)

Prismis routes LLM calls through two services so routine work and deep synthesis can use different models. Provider routing is handled by llm-core via ~/.config/llm-core/services.toml; the daemon only references service names.

```toml

~/.config/prismis/config.toml

[llm] light_service = "prismis-openai" # required — used for priority/summary/context analysis deep_service = "prismis-openai-deep" # optional — second-tier synthesis on HIGH items auto_extract = "high" # "high" | "medium" | "none" — gate for auto deep extraction

The light service handles every routine call (fetch-cycle priority, summarization, context analyzer). The deep service runs the second-tier synthesis prompt that produces the Counterintuitive / Buried lede / So what / Pushback sections plus quotables. When `deep_service` is unset, the daemon runs in light-only mode (graceful degradation — deep extraction failures never block storage).

Service definitions live in `~/.config/llm-core/services.toml`, where you map service names to providers, models, and API keys. Examples:

~/.config/llm-core/services.toml

[services.prismis-openai] provider = "openai" model = "gpt-4o-mini" key = "openai"

[services.prismis-openai-deep] provider = "openai" model = "gpt-5-mini" # reasoning-class model recommended for deep synthesis key = "openai"

[services.prismis-anthropic] provider = "anthropic" model = "claude-3-haiku-20240307" key = "anthropic"

[services.prismis-ollama] provider = "ollama" model = "llama2" base_url = "http://localhost:11434"

API keys are resolved by `apiconf` from `~/.config/apiconf/config.toml`; `key = "openai"` references the entry named `openai` there. Run `prismis-daemon migrate-config` once after upgrading from a pre-iter-12 install — it idempotently rewrites the config to dual-service shape and adds the `[services.prismis-openai-deep]` stub.

**Reddit API** (optional - improves reliability):

Add to ~/.config/prismis/.env for better Reddit access

REDDIT_CLIENT_ID=your-reddit-client-id REDDIT_CLIENT_SECRET=your-reddit-client-secret ```

Configure TTS provider (optional)

~/.config/prismis/config.toml

[audio] provider = "system" # Free macOS/Linux TTS (default)

voice = "your-voice-id" # ElevenLabs voice ID (optional)

Requires [lspeak](https://github.com/nickpending/lspeak) for TTS generation:

For ElevenLabs (optional premium quality)

export ELEVENLABS_API_KEY=your-api-key ```

Set your API keys

edit ~/.config/prismis/.env # Add your OPENAI_API_KEY

Web Interface

The daemon serves a beautiful web interface on your local network:

```bash

Terminal Interface

prismis           # Launch instantly (local mode)
prismis --remote  # Remote mode with incremental sync from server daemon

Essential Keys: - 1/2/3 - View HIGH/MEDIUM/LOW priority content - j/k - Navigate up/down (vim-style) - Enter - Read full article - +/- - Upvote/downvote content (trains AI prioritization) - i - Flag item as interesting (for context analysis) - : - Command mode (see below) - S - Manage sources - ? - Show all keyboard shortcuts - q - Quit

Command Mode (press : to enter): - :fabric <pattern> - Run any of 200+ AI patterns (tab completion available) - :fabric extract_wisdom - Extract key insights - :fabric summarize - Create concise summary - :fabric analyze_claims - Fact-check claims - :fabric explain_terms - Explain technical terms - :context suggest - Get LLM topic suggestions from flagged items (requires flagging with i) - :context edit - Open context.md in $EDITOR - :context review - Show count of flagged items ready for analysis - :audio - Generate audio briefing from HIGH priority items (requires lspeak) - :export sources - Copy all configured sources to clipboard for backup - :mark - Mark article as read/unread - :copy - Copy article content - :prune - Remove unprioritized items (with y/n confirmation) - :prune! - Force remove without confirmation - :prune 7d - Remove items older than 7 days - :help - Show all available commands

CLI Automation

Query and export content for automation workflows:

```bash

Change: OPENAI_API_KEY=sk-your-key-here

```

API Access

The daemon exposes a REST API for custom integrations and the web interface.

Full API Documentation: See API.md for complete endpoint reference, authentication, request/response formats, and client examples.

Quick Examples:

```bash

Context Assistant Workflow

Improve your context.md over time by flagging interesting unprioritized items:

1. Flag interesting items - Press i on unprioritized content that should have matched your topics but didn't 2. Get suggestions - Run :context suggest to analyze flagged items with LLM 3. Review analysis - Suggestions copied to clipboard with gap analysis: - Add: New topic area not covered - Expand: Existing topic too narrow - Narrow: Existing topic too broad - Split: One topic covering unrelated things 4. Update context.md - Run :context edit or manually update based on suggestions 5. Repeat - As you flag more items, patterns emerge and your context improves

The LLM studies your existing topic style (length, phrasing, tone) and matches it in suggestions.

Fabric Integration

Built-in AI analysis using 200+ Fabric patterns. Tab completion helps you discover all available patterns:

```bash