convez.ai
MCP Server
p10ns11y

collab-finder

p10ns11y/collab-finder

Ver no GitHub
InicialPluginScore · de 0 a 100

Personal intelli dashboard (Tauri + Rust + React) for discovering jobs, collabs, side hustles & community builds on X using live X API + xAI. Flexible query tuning, full prep (CV sidecars + cover letters + research), promote insights back to portfolio CV. Separate from public devprofile portfolio.

Instalação

$npx convez-ai p10ns11y/collab-finder

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
2
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 13 horas
Versão
v1.2.0
Issues abertas
3
Contribuidores
1

README

A tradução para o português deste README ainda está na fila.

collab-finder

Agentic X opportunity finder (Tauri desktop): self-guarded reactor, MVU React shell, secure X + xAI credentials, and a path to MCP autonomy. You intervene when guards fire — not on every step.

Prerequisites

ToolNotes
Node.jsLTS recommended
pnpmcorepack enable or install globally
RustStable toolchain + cargo
Tauri v2 system depsLinux: GTK/WebKit, libsecret/keyring. See Tauri prerequisites.

Arch/Linux detail, credential storage, and troubleshooting: docs/SETUP.md.

Quick start

pnpm install
pnpm tauri dev

First launch opens Discover (opportunity rail + Quick Target). Sidebar nav: Discover · Xplore · Settings.

First-run tour

Settings — credentials

  1. Open Settings in the sidebar.
  2. X connection — paste your app Bearer token, Save credentials. Token is stored in Rust (not kept in UI state). Panel shows keyring vs file fallback via get_x_bearer_storage.
  3. xAI key — paste your xAI API key for Quick Target analyze/prep on Discover. Same keyring/file pattern via get_xai_key_storage.

Discover — opportunities + Quick Target

  1. Your Opportunities rail (left) — persisted job rows from SQLite; click to hydrate fit + prep from stored blobs (no new xAI call).
  2. CV summary — grounds analyze/prep; persisted in localStorage.
  3. Quick Target — paste a job URL or JD, Evaluate fit (live xAI), then Generate prep. Optimistic row appears in the rail; server reconciles on refresh.

Xplore — live X search + reactor cycle

  1. Search workspace — live recent search (search_x_recent).
  2. Run autonomous cycle — live X search via guarded_search, heuristic analyze in the reactor (xAI structured decisions for the cycle path are still planned); tweets + SQLite history.
  3. Stats, raw history tables, and archive lookup are not in the sidebar today — use the command palette (⌘K / Ctrl+K) for search, cycle, presets, and history refresh where wired.

Verify

pnpm build
cd src-tauri && cargo check
cd src-tauri && cargo test

cargo test covers secrets, db, reactor, and query validation (no live X token required). package.json does not yet define type-check, lint, or precommit scripts (see AGENTS.md for planned checks).

Architecture (short)

LayerLocation
MVU UI + guardssrc/core/finder/, src/view/, src/components/finder/
Discover / Xplore / Settings screenssrc/view/screens/, src/components/layout/sidebar-nav.tsx
Tauri bridgesrc/adapters/tauri/, src/ports/
Live X search + secretssrc-tauri/src/lib.rs, commands.rs, secrets.rs
Quick Target + xAIsrc-tauri/src/opportunity_target.rs
Durable history (SQLite)src-tauri/src/db.rs, history MVU slices
Reactor + guards (Rust)src-tauri/src/finder_reactor.rs

Tauri commands (25 handlers)

Grouped inventory (MCP server planned; today: invoke only). Full table: docs/tauri-commands.md.

GroupCommands
X bearerhas_x_bearer, get_x_bearer_storage, set_x_bearer, clear_x_bearer
xAI keyhas_xai_key, get_xai_key_storage, set_xai_key, clear_xai_key
Quick Targetfetch_opportunity_target_page, analyze_opportunity_target, prep_opportunity_target, get_opportunities
Finder / reactorsearch_x_recent, run_finder_cycle_cmd, get_reactor_state, promote_lead
History / auditget_search_history, get_search_run, get_leads, get_dashboard_stats, get_recent_pauses, get_events, search_past_tweets, hydrate_tweet, log_event

Documentation

DocPurpose
docs/SETUP.mdInstall, credentials, verify, Arch notes
docs/agentic-architecture.mdSystem map, mermaid, milestone matrix
docs/tauri-commands.mdAll invoke handlers
docs/tauri-ipc-and-intent-engine.mdIPC Intent Engine, Arch/Linux
docs/tauri-ipc-debugging.mdDev: intercept and debug invoke
docs/tauri-webview-and-devtools.mdLinux WebKit WebView, Safari-like inspector, console invoke QA
.agents/skills/tauri-ipc-debug/Agent skill: layer-by-layer IPC triage
docs/x-tools.mdOfficial X agent resources
data/distillation/README.mdSearch presets, curation, analyze prompts (UI source)
.agents/x-resources/README.mdOfficial X skill.md / llms snapshots + refresh
reports/intuitive-shell-plan.mdExecutable UX plan (Discover / Xplore / Settings)

Diagrams in-repo; interactive architecture canvas is Cursor-only — see agentic-architecture.md.

Agent / dev resources

  • AGENTS.md — skills index, triage, conventions (type-check / lint / precommit not in package.json yet)
  • docs/x-tools.md — official X llms.txt, skill.md, XMCP, xurl
  • .agents/skills/ — finder-reactor, tauri-agentic, cv-promote-guard, x-agent-resources, fusion-sage

Data handling (X content)

  • Post data is fetched via the official X API for personal productivity use only.
  • SQLite stores post IDs, links (https://x.com/i/web/status/{id}), and 280-character snippets for local preview and FTS — not full post bodies.
  • Full text is available on demand via hydrate_tweet (lookup API; fresh data, 404 if deleted). Live search/cycle responses return full text from the API but only snippets are persisted.
  • The local database (collab-finder.db) is never committed to the repo.

See docs/x-content-storage-distributin-policy.md for rationale.

Private tool for p10ns11y.

Ver o original no GitHub

Bom para

Relacionados