Traul — Personal Intelligence Engine

Trust Score 87/100

from traul108

CLI that indexes messages across Slack, Telegram, Discord, Gmail, Claude Code sessions and Markdown to provide fast hybrid search, signal detection, and briefin

triggers:traulsyncsearchsignalsbriefingpersonal intelligencemessage index

GitHub SKILL.md

What it does

Traul is a local-first CLI personal intelligence engine that syncs messages from Slack, Telegram, Discord, Linear, Gmail, Claude Code sessions, and Markdown files, indexes them (FTS5 + vector), and provides hybrid semantic+keyword search, signals/pattern detection, briefings, and threaded retrieval. It helps users search historical conversations, run automated signal checks, and produce structured briefings from aggregated communications.

When to use it

Use Traul when you need a searchable local archive of your communication streams, want to run SQL-like signals to detect issues, generate briefings, or perform ad-hoc hybrid semantic searches across multiple sources without relying on cloud search. Good for engineers, support leads, and knowledge workers who need fast local search and alerting across many chat platforms.

What's included

Scripts: CLI commands for sync, search, get, messages, channels, signals, briefing, sql, and reset (project provides a full Commander.js-based CLI).
References: Detailed connector descriptions for Slack, Telegram, Linear, Claude Code, and Markdown sources; database schema and signal examples are included in the skill body.
Instructions: Practical guidance for sync strategy, search modes (hybrid, FTS, OR, LIKE), signal definition and usage, and DB/schema inspection.

Compatible agents

Likely compatible with developer-focused agents and local execution environments (CLI-driven agents like Codex/Copilot that can run shell commands).

Audit Summary

Traul is a personal intelligence engine CLI that indexes messages across Slack, Telegram, Discord, Gmail, Linear, Claude Code sessions and Markdown files for hybrid search and signal detection. The bundled tg_sync.py script failed due to missing telethon and pyyaml dependencies. The SKILL.md is exceptionally well-documented with clear command references, JSON output schemas, connector details, and workflow examples. No security concerns — no exfiltration, no destructive commands, no phone-home telemetry.

Watch Out

Requires Bun runtime + SQLite + node-llama-cpp (or Ollama) for embeddings — heavy setup
Bundled tg_sync.py needs telethon and pyyaml Python packages
Project path in SKILL.md hardcoded to /Users/dandaka/projects/traul
traul sync can take up to 1 hour — skill warns against running it casually

Missing Dependencies

telethonpyyaml

Notes

Well-architected skill with thorough documentation. The SKILL.md is one of the most detailed I've seen — includes CLI reference, JSON schemas, connector configs, signals system, and database schema. Main limitation is heavy dependency chain (Bun, Telethon, Ollama/embeddings model) which limits out-of-the-box usability. The single bundled script is a Telegram sync helper that depends on external telethon library.

Information

Repository: traul
Stars: 108
Installs: 0

Trust Score

Overall87

Security95

Code Quality78

Architecture82

Usefulness68

Related Skills

Readwise Reader Document Management

Manage Readwise Reader documents: list, save, search, move, tag, highlight, export and bulk-edit via official and custom CLIs.

ezBookkeeping API Tools

Command-line API tools for ezBookkeeping: record and query transactions, retrieve accounts/categories/tags, and fetch exchange rates for self-hosted personal fi

Tmux Bridge

Give an agent controlled access to a local tmux terminal bridge so it can run shell commands, capture output, and manage sessions on the user's machine.

SourceSage CLI

Generate concise, LLM-friendly repository summaries (Markdown) using the SourceSage CLI — supports lite mode, language switching, and targeted repo analysis.

Nit (Nitter CLI)

Terminal client to browse tweets, view profiles, and search posts via Nitter instances without opening a browser.

hn — Hacker News CLI

Terminal-based Hacker News client with a CLI and optional interactive TUI for browsing top/new/best/ask/show/jobs stories, viewing threads with nested comments,

Lokalise Migration — Deep Dive

Step-by-step migration guide and tooling for moving translations from Crowdin/Phrase/POEditor into Lokalise, including transforms, uploads and validation.

Vercel Common Errors

Diagnose and fix common Vercel build, serverless runtime, and edge/routing errors with step-by-step checks and fixes.

Back to Skills