jevlin-go

module
v0.1.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 13, 2026 License: Apache-2.0

README

jevlin

Web search for coding agents that pays the person running the agent. One binary gives Claude Code, Cursor, Codex, opencode, Pi and Hermes a web search through the Twilight search router. If you turn mining on, those searches earn Twilight Slot rewards to an address you control. There is no daemon, proxy or MCP server: between tool calls nothing is running.

Install

npm install -g @jevlinsearch/jevlin
jevlin setup

Install it globally, never with npx: setup writes the binary's path into your agents' skills and hooks, and npm throws away an npx cache or a project's node_modules.

Without Node, download the archive for your OS and architecture from the releases page and verify it against that release's checksums.txt. Put jevlin in a directory only you can write, such as ~/.local/bin, and run jevlin setup from there. Setup and agents install refuse a binary under the temp directory, or in a directory another user owns or every user can write, and warn about one a shared group can write. On Windows only the temp-directory rule is checked.

What setup asks

Setup registers with the search platform and stores the key it gets back, so there is no key to copy or paste. Then it asks, in this order:

question what your answer does
Use it? Asked only when an earlier installation was set aside beside ~/.jevlin. Yes moves it back.
Enable mining rewards? No, the default, still gives you search. Yes asks for a payout address.
Payout address A twilight1… address you control, or empty to create a wallet here.
Add them to ~/.zshrc? Or whichever profile your shell reads. Puts jevlin on PATH and sets JEVLIN_CONFIG. On Windows it asks Set them for your user? instead.
Set up the coding agents found on this machine now? Writes a skill and hooks into each agent's own config, after showing you what.

Then it prints a link where you claim your agent. The guide says what each answer does and which flags answer them for you.

Then check

jevlin status          # what this installation has and has not completed
jevlin agents status   # which agents are set up
jevlin doctor          # whether searches are recorded and earning, check by check
jevlin search -format model "what is proof of authority consensus"

It is working when the search prints results and agents status lists your agents as installed. Restart any agent that was already open.

The agents it sets up

agent what is written one thing to know
Claude Code a skill; hooks and allow rules in ~/.claude/settings.json On Windows, a search through its PowerShell tool asks for approval.
Cursor a skill; hooks in ~/.cursor/hooks.json Cursor also runs Claude Code's hooks, which stand aside for it.
Codex a skill; on macOS and Linux, hooks in ~/.codex/hooks.json and a permission profile in ~/.codex/config.toml that opens only the search hosts; on Windows, writable directories in that file and no network Its hooks run only once you approve them in Codex. Supported with Codex 0.158.0 or newer; older versions are not supported.
opencode a plugin, and a line for you to paste into AGENTS.md /jevlin off does not reach it.
Pi a skill and an extension under ~/.pi/agent/ A resumed session keeps its place in the trace.
Hermes a skill; a hook in config.yaml Approve the hook once; it loads next session.

Any other agent: agents.md says what to paste.

How earning works

  • Your first reward takes one to two hours. You join an epoch two ahead, and it has to close and settle first.
  • One verified search per epoch makes you eligible. More searches do not earn more.
  • The pot splits equally among everyone eligible in that epoch.
  • A long idle gap can miss an epoch. Recorded searches are submitted by the next search or agent session, and evidence that arrives after the epoch's deadline is late.

Search works before you claim your agent, and with mining off. The guide has the detail.

What leaves the machine

Each search carries a trace, so the router can group one task's searches. It holds hashed session and turn ids, a call counter, and the assistant text just before the search, capped at 32 KB. That text goes only to the search router, inside the search request; the rewards service receives metadata only.

export JEVLIN_TRACE=off sends no trace, and searches earn the same without it. See what travels with a search.

A wallet setup creates is sealed by the passphrase you choose, and its 24-word recovery phrase is printed once. Where rewards land says how to keep both safe.

Upgrading and removing

jevlin upgrade                 # a native install: the latest release, verified before it runs
npm install -g @jevlinsearch/jevlin@latest   # an npm install is updated with npm
jevlin uninstall               # remove the skills, hooks and profile block; keep your wallet

The guide covers upgrading and removing it and coming back.

Documentation

  • Jevlin guide: setup in detail, the wallet, earning, upgrading, removing.
  • Agents: what is written into each coding agent, and its known limits.
  • Reference: commands, the --stdin envelope, config, environment variables, files, doctor's checks.
  • CHANGELOG.md: what changed in each release.
  • SECURITY.md: how to report a vulnerability.
  • CONTRIBUTING.md: how to propose a change.

License

Apache-2.0.

Directories

Path Synopsis
cmd
jevlin command
Command jevlin is the Twilight drop-in search miner.
Command jevlin is the Twilight drop-in search miner.
internal
netdial
Package netdial is the one dial seam every http.Transport this module builds in production code goes through — not by sharing one dialer, but by sharing one hook every transport's own dialer checks first.
Package netdial is the one dial seam every http.Transport this module builds in production code goes through — not by sharing one dialer, but by sharing one hook every transport's own dialer checks first.
networkfence
Package networkfence is test-only infrastructure: no production code anywhere in this module imports it.
Package networkfence is test-only infrastructure: no production code anywhere in this module imports it.
selfupdate
Package selfupdate finds, verifies and stages a canonical Jevlin release for a native self-upgrade.
Package selfupdate finds, verifies and stages a canonical Jevlin release for a native self-upgrade.
termtext
Package termtext holds the one rule for text this client received from somewhere else and will print: the platform's responses, and the records it wrote back into a state directory a sandboxed agent can rewrite.
Package termtext holds the one rule for text this client received from somewhere else and will print: the platform's responses, and the records it wrote back into a state directory a sandboxed agent can rewrite.
winacl
Package winacl is the Windows access-list handling that pkg/auth and cmd/jevlin both need: reading an object's owner and DACL into plain values, naming a SID, and giving an object a protected owner-only list.
Package winacl is the Windows access-list handling that pkg/auth and cmd/jevlin both need: reading an object's owner and DACL into plain values, naming a SID, and giving an object a protected owner-only list.
pkg
auth
Package auth owns the proxy's AS-facing control plane.
Package auth owns the proxy's AS-facing control plane.
config
Package config resolves the proxy configuration exactly once at startup — defaults, then a TOML file (JEVLIN_CONFIG names it), then the proxy-era TOKENDROP_* listener variables, then flags — into an immutable struct.
Package config resolves the proxy configuration exactly once at startup — defaults, then a TOML file (JEVLIN_CONFIG names it), then the proxy-era TOKENDROP_* listener variables, then flags — into an immutable struct.
fsx
Package fsx publishes complete files with explicit durability semantics.
Package fsx publishes complete files with explicit durability semantics.
mining/collector
Package collector delivers spooled observations to the AS (contract §58, §63–§64).
Package collector delivers spooled observations to the AS (contract §58, §63–§64).
mining/draw
Package draw holds the proxy's Selection identity: custody of the local participation_secret and the frozen DrawIDV1 derivation (Participant Selection V1 r5 §36–§38), plus the CandidateSetHashV1 construction and CandidateList canonicality checks a self-verifying proxy needs (r5 §19, §39).
Package draw holds the proxy's Selection identity: custody of the local participation_secret and the frozen DrawIDV1 derivation (Participant Selection V1 r5 §36–§38), plus the CandidateSetHashV1 construction and CandidateList canonicality checks a self-verifying proxy needs (r5 §19, §39).
mining/promote
Package promote turns a terminal proxy observation into a ProviderObservationV1 record (contract §54 promotion rule, §48–§57 envelope).
Package promote turns a terminal proxy observation into a ProviderObservationV1 record (contract §54 promotion rule, §48–§57 envelope).
mining/scope
Package scope holds the Participation Context a mining-plane pass snapshots at capability time (contract §4.2, §32).
Package scope holds the Participation Context a mining-plane pass snapshots at capability time (contract §4.2, §32).
mining/spool
Package spool is the proxy's durable observation queue (PX-15).
Package spool is the proxy's durable observation queue (PX-15).
observe
Package observe watches provider responses without retaining them: the bounded lossy tap (ADR-0002), the structural scanner (ADR-0004), the Observation type, and the Sink it is delivered through.
Package observe watches provider responses without retaining them: the bounded lossy tap (ADR-0002), the structural scanner (ADR-0004), the Observation type, and the Sink it is delivered through.
platform
Package platform is the client for the search platform's public control plane (agent onboarding design, search-platform-agent- onboarding-design.md §5.1-§5.3): register, poll, enroll.
Package platform is the client for the search platform's public control plane (agent onboarding design, search-platform-agent- onboarding-design.md §5.1-§5.3): register, poll, enroll.
redact
Package redact is the single place a log handler is constructed and the choke point every log line passes through.
Package redact is the single place a log handler is constructed and the choke point every log line passes through.
wire
Package wire holds the proxy↔AS data models frozen by the V1 integration contract: ProviderObservationV1 (§48–§57), the submission acknowledgement (§58–§59), the stable error envelope (§26), and the Twilight service-metadata document (§19).
Package wire holds the proxy↔AS data models frozen by the V1 integration contract: ProviderObservationV1 (§48–§57), the submission acknowledgement (§58–§59), the stable error envelope (§26), and the Twilight service-metadata document (§19).
tools
releasecheck command
Command releasecheck holds the deterministic half of the release pipeline: the checks that decide whether a pushed tag may become a published release, and whether what was published is what was meant.
Command releasecheck holds the deterministic half of the release pipeline: the checks that decide whether a pushed tag may become a published release, and whether what was published is what was meant.
testshard command
Command testshard runs one part of a package set's tests, so a slow test run can be split across CI jobs that run at the same time.
Command testshard runs one part of a package set's tests, so a slow test run can be split across CI jobs that run at the same time.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL