Skip to content

run.md

Latest commit

 

History

History
77 lines (50 loc) · 3.77 KB

run.md

File metadata and controls

77 lines (50 loc) · 3.77 KB
Raw

Run and configure

Build

From the repository root:

make lint
make test
make run     # debug binary on 127.0.0.1:4700
make build   # release: itcy + linkedin-itcy-gr-mcp

GET /health returns ok when the process is up. GET /status is JSON (routes, Tor, enrich queue, webhook wake).

The terminal UI is a separate repo: itcy-tui. It lists publications from GitHub and, when this binary is up, shows live health and saved drafts.

Writer prompts are not in this tree. The build copies operator prompt files when present; otherwise it embeds short stubs so cargo still succeeds.

Config

Committed defaults: backend/config.toml.

Override Role
ITCY_CONFIG Path to an alternate TOML file
ITCY_BIND Listen address (default 127.0.0.1:4700)
ITCY_STATE_DB SQLite path (default sql/runtime.db relative to make run cwd)
ITCY_LINKEDIN_EXPORT_DIR Official LinkedIn export directory (zip or unzipped). Never commit it.
ITCY_TOR_BIN Tor daemon binary for /enrich (SOCKS 9050, control 9051)
ITCY_PUBLIC_FETCH_CMD Optional HTML fetch helper (default scripts/fetch-public-page.sh)
ITCY_PW_BROWSER Ingest thin-page fetch only: brave, chromium, or opt-in obscura (default unset = legacy Brave/Chromium launch)
ITCY_BROWSER_EXECUTABLE Override browser or Obscura binary path (tools/obscura/obscura when ITCY_PW_BROWSER=obscura and unset)
ITCY_OBSCURA_CDP_PORT CDP port for obscura serve (default 9222) when using Obscura ingest fetch
Slack / GitHub / X env keys named in config.toml Tokens in gitignored .env

Copy env names from backend/config.toml (*_env fields). Do not commit .env, .linkedin, or .twitter.

Production LinkedIn ship calls the local MCP at http://127.0.0.1:4780/mcp when [linkedin] publish_mode = "production". Start it with .cursor/scripts/linkedin-vahabcore-up.sh after LINKEDIN_ACCESS_TOKEN is set. That MCP is vahabcore/linkedin-mcp-server (thanks Abdulvahab Shaikh). Slack /reply_comment drafts a LinkedIn or X reply (CREPLY- / XREPLY-); /accept ships (LinkedIn playground = notice; LinkedIn production = MCP reply_to_comment; X = threaded Brave/API reply). No publications BAT PR for replies.

Tor

/enrich fetches personal LinkedIn post URLs over Tor.

export ITCY_TOR_BIN=/path/to/tor
make tor-up     # SOCKS 9050 + control 9051
make tor-down

Data directory: sql/tor-data/ (gitignored). Template: docker/torrc.

LinkedIn export

Place an official export under linkedin-export/ (gitignored). Point linkedin_export_dir or ITCY_LINKEDIN_EXPORT_DIR at that folder, then:

cd backend && cargo run -p itcy --bin import-linkedin-export

Ongoing adds: Slack /enrich (Tor, post URLs) and /ingest (public pages).

Obscura ingest (opt-in)

Thin-page /ingest fallback only (scripts/fetch-public-page.sh). Default unchanged. Set ITCY_PW_BROWSER=obscura in .env to try Obscura CDP; install binary under tools/obscura/. Compare baseline vs Obscura: make obscura-parity. Draft research (playwright-mcp.sh) and X ship are unchanged.

GitHub wake

ITCy listens on POST /hooks/github (loopback). Point a GitHub webhook at your ingress so BAT Approve reaches the process. HMAC verification belongs on the ingress, not in this binary.

Slack

Socket Mode. Channel and bot tokens via .env as named in [slack]. Without them, HTTP still runs.

X

Digest pulse and production ship use Brave against a local profile (scripts/fetch-twitter-pulse.sh, scripts/post-twitter.sh, scripts/open-twitter-login.sh). Optional Bearer API when TWITTER_BEARER is set.