BranchesTags

Repository files navigation

Tollbit CLI

CLI client for searching and grounding content for agents, allows access to all content in the TollBit network.

Binaries and installers are published on GitHub Releases.

Primary workflow: install → search → content pricing → content fetch. Authentication is triggered automatically by the CLI when needed.

Install

Agent install prompt

Agent?: Install Tollbit from github.com/tollbit/cli using the install script or package that your environment needs (below), then run tollbit guide --install <SKILLS_DIR> to register the bundled skill.

macOS and Linux

curl -fsSL "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.sh"| bash

Pin a version or choose an install directory:

curl -fsSL "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.sh"| bash -s -- --version v0.2.5
curl -fsSL "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.sh"| bash -s -- --install-dir "$HOME/bin" --force

By default the binary goes under ~/.local/bin; the installer can add that directory to your shell PATH. Use --no-modify-path to skip PATH changes in CI or locked environments.

Windows (PowerShell)

irm "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.ps1"| iex

Pin a version or skip PATH changes (useful in CI):

irm "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.ps1"| iex
Install-Tollbit-Version v0.2.5-Force
Install-Tollbit-NoModifyPath -PrintPathInstructions

npm

npm install -g @tollbit/tollbit-cli

Then run tollbit from any terminal (the package downloads the native binary for your OS).

Manual install

From GitHub Releases, download the archive for your OS and CPU, verify SHA-256 against tollbit_<version>_checksums.txt, and put tollbit (or tollbit.exe) on your PATH.

Build from source

go build ./cmd/tollbit

See CONTRIBUTING.md for local development and release instructions.

For AI coding agents

  • Install tollbit so it is on PATH in every environment where you run shell commands (CI images, local sandboxes, agent runners).
  • Run tollbit guide for orientation, then tollbit guide --install <SKILLS_DIR> to persist the bundled skill. The guide is the full automation contract (exit codes, streams, non-interactive fetch).
  • Typical flow: search → content pricing → content fetch. The CLI prompts for authentication when a token is required.
  • Optionally set an agent profile with tollbit auth set --name <name> (or TOLLBIT_AGENT_DEFAULT_NAME) / --user-agent.
  • Prefer --json on search, content pricing, content fetch, feedback, and auth status. Exit codes: 0 success, 1 runtime, 2 usage; stdout is data-only (hints and errors on stderr).

What the CLI can do

CommandPurpose
search "query"Search publisher content via the gateway API.
content pricing/fetchPrice and fetch licensed publisher content.
feedback "message"Submit CLI / agent feedback (requires OBO).
auth login/logout/status/setAgent profile and OAuth authorization token (also run automatically when needed).
guidePrint the agent guide; optionally install bundled skill markdown.
versionPrint the CLI version string.

Typical flow: search "query" → content pricing <url> → content fetch <url>. Use --help on each command for flags.

Commands

Search

Search first; the CLI will prompt for authentication if your session is not ready yet.

tollbit search "climate policy"
tollbit search "climate policy" --size 10 --json
tollbit search "query" --properties example.com,cnn.com --programmatic-only

Content

Price and fetch licensed publisher content:

tollbit content pricing https://example.com/article-1,https://example.com/article-2
tollbit content pricing https://example.com/article --json
tollbit content fetch https://example.com/article
tollbit content fetch https://example.com/article --confirm --toDisk ./article.md
tollbit content fetch https://example.com/article --confirm --json --rate-index 1

Every fetch charges money. Pricing is shown and you must confirm unless you pass --confirm (automation still incurs cost). Use --toDisk=<path> to save fetched content locally. When no user agent is configured, the org default -tbcli- agent is used. Set a registered user agent with auth set --user-agent or --user-agent on the fetch command.

Feedback

Submit product feedback (requires an OBO-linked agent session):

tollbit feedback "search ranking felt off for this query"
tollbit feedback "great fetch UX" --rating 5 --category content
tollbit feedback "auth hung" --rating 2 --category auth --metadata source=cli --json

Auth

Auth runs automatically when a command needs a token. Use these commands to inspect or manage the profile explicitly:

tollbit auth login --name my-agent --user-agent MyAgent-User
tollbit auth status
tollbit auth status --json
tollbit auth status --check
tollbit auth set --name my-agent --user-agent MyAgent-User
tollbit auth logout
tollbit auth logout --all

Logging in again (tollbit auth login) mints a new token and revokes all previous ones — use it if you believe a token was exposed. auth logout revokes the current token; auth logout --force clears local credentials even if the server can't be reached (the token is then revoked at your next login or expires within 30 days).

TOLLBIT_AGENT_DEFAULT_NAME and TOLLBIT_AGENT_DEFAULT_USER_AGENT set fallback profile defaults. Saved profile overrides those defaults. search and content accept --user-agent as a per-request override.

auth status --check exits 0 when the token is valid, 1 when invalid/expired, and 2 when missing (no stdout).

Set TOLLBIT_AUTH_BROWSER_CONSENT_AUTO_OPEN_BROWSER=false in headless environments.

Guide

tollbit guide
tollbit guide --install ~/.claude/skills

Install writes <dir>/<skill-name>/SKILL.md (name from embedded frontmatter, e.g. tollbit-cli).

Version

tollbit version
tollbit --version

Compare to the version field in the embedded skill when deciding whether to refresh an installed skill.

Updating

Installer channel updates:

# Latest
curl -fsSL "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.sh"| bash
# Pinned
curl -fsSL "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.sh"| bash -s -- --version v0.2.5 --force
irm "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.ps1"| iex
Install-Tollbit-Version latest -Force

Other channels:

  • npm: npm update -g @tollbit/tollbit-cli

Assumptions

  • Gateway API base URL defaults to https://gateway.tollbit.com (agent search).
  • Agent identity tokens are minted via the auth service (TOLLBIT_AUTH_BASE_URL).

Configure

Agent credentials are stored under TOLLBIT_CREDENTIALS_STORAGE_DIR (default platform path): agent-identity.json and agent-token.jwt.

License

MIT — see LICENSE. Binary distributions include third-party license notices in THIRD-PARTY-NOTICES.md.

About

Search and fetch licensed publisher content for AI agents on the TollBit network.

tollbit.com

Topics

ai-agentsclicontent-licensinggolangllmragtollbit

Resources

Readme
MIT license

Contributing

Contributing
Activity
Custom properties

Stars

0 stars

Watchers

2 watching

Forks

0 forks
Report repository

Releases

Packages

Used by

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all 
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '

Skip to content
BranchesTags
Repository files navigation
Tollbit CLI
CLI client for searching and grounding content for agents, allows access to all content in the TollBit network.
Binaries and installers are published on GitHub Releases.
Primary workflow: install → search → content pricing → content fetch. Authentication is triggered automatically by the CLI when needed.
Install
Agent install prompt
Agent?: Install Tollbit from github.com/tollbit/cli using the install script or package that your environment needs (below), then run tollbit guide --install <SKILLS_DIR> to register the bundled skill.
macOS and Linux
curl -fsSL "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.sh"| bash
Pin a version or choose an install directory:
curl -fsSL "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.sh"| bash -s -- --version v0.2.5
curl -fsSL "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.sh"| bash -s -- --install-dir "$HOME/bin" --force
By default the binary goes under ~/.local/bin; the installer can add that directory to your shell PATH. Use --no-modify-path to skip PATH changes in CI or locked environments.
Windows (PowerShell)
irm "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.ps1"| iex
Pin a version or skip PATH changes (useful in CI):
irm "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.ps1"| iex
Install-Tollbit-Version v0.2.5-Force
Install-Tollbit-NoModifyPath -PrintPathInstructions
npm
npm install -g @tollbit/tollbit-cli
Then run tollbit from any terminal (the package downloads the native binary for your OS).
Manual install
From GitHub Releases, download the archive for your OS and CPU, verify SHA-256 against tollbit_<version>_checksums.txt, and put tollbit (or tollbit.exe) on your PATH.
Build from source
go build ./cmd/tollbit
See CONTRIBUTING.md for local development and release instructions.
For AI coding agents
  • Install tollbit so it is on PATH in every environment where you run shell commands (CI images, local sandboxes, agent runners).
  • Run tollbit guide for orientation, then tollbit guide --install <SKILLS_DIR> to persist the bundled skill. The guide is the full automation contract (exit codes, streams, non-interactive fetch).
  • Typical flow: search → content pricing → content fetch. The CLI prompts for authentication when a token is required.
  • Optionally set an agent profile with tollbit auth set --name <name> (or TOLLBIT_AGENT_DEFAULT_NAME) / --user-agent.
  • Prefer --json on search, content pricing, content fetch, feedback, and auth status. Exit codes: 0 success, 1 runtime, 2 usage; stdout is data-only (hints and errors on stderr).
What the CLI can do
CommandPurpose
search "query"Search publisher content via the gateway API.
content pricing/fetchPrice and fetch licensed publisher content.
feedback "message"Submit CLI / agent feedback (requires OBO).
auth login/logout/status/setAgent profile and OAuth authorization token (also run automatically when needed).
guidePrint the agent guide; optionally install bundled skill markdown.
versionPrint the CLI version string.
Typical flow: search "query" → content pricing <url> → content fetch <url>. Use --help on each command for flags.
Commands
Search
Search first; the CLI will prompt for authentication if your session is not ready yet.
tollbit search "climate policy"
tollbit search "climate policy" --size 10 --json
tollbit search "query" --properties example.com,cnn.com --programmatic-only
Content
Price and fetch licensed publisher content:
tollbit content pricing https://example.com/article-1,https://example.com/article-2
tollbit content pricing https://example.com/article --json
tollbit content fetch https://example.com/article
tollbit content fetch https://example.com/article --confirm --toDisk ./article.md
tollbit content fetch https://example.com/article --confirm --json --rate-index 1
Every fetch charges money. Pricing is shown and you must confirm unless you pass --confirm (automation still incurs cost). Use --toDisk=<path> to save fetched content locally. When no user agent is configured, the org default -tbcli- agent is used. Set a registered user agent with auth set --user-agent or --user-agent on the fetch command.
Feedback
Submit product feedback (requires an OBO-linked agent session):
tollbit feedback "search ranking felt off for this query"
tollbit feedback "great fetch UX" --rating 5 --category content
tollbit feedback "auth hung" --rating 2 --category auth --metadata source=cli --json
Auth
Auth runs automatically when a command needs a token. Use these commands to inspect or manage the profile explicitly:
tollbit auth login --name my-agent --user-agent MyAgent-User
tollbit auth status
tollbit auth status --json
tollbit auth status --check
tollbit auth set --name my-agent --user-agent MyAgent-User
tollbit auth logout
tollbit auth logout --all
Logging in again (tollbit auth login) mints a new token and revokes all previous ones — use it if you believe a token was exposed. auth logout revokes the current token; auth logout --force clears local credentials even if the server can't be reached (the token is then revoked at your next login or expires within 30 days).
TOLLBIT_AGENT_DEFAULT_NAME and TOLLBIT_AGENT_DEFAULT_USER_AGENT set fallback profile defaults. Saved profile overrides those defaults. search and content accept --user-agent as a per-request override.
auth status --check exits 0 when the token is valid, 1 when invalid/expired, and 2 when missing (no stdout).
Set TOLLBIT_AUTH_BROWSER_CONSENT_AUTO_OPEN_BROWSER=false in headless environments.
Guide
tollbit guide
tollbit guide --install ~/.claude/skills
Install writes <dir>/<skill-name>/SKILL.md (name from embedded frontmatter, e.g. tollbit-cli).
Version
tollbit version
tollbit --version
Compare to the version field in the embedded skill when deciding whether to refresh an installed skill.
Updating
Installer channel updates:
# Latest
curl -fsSL "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.sh"| bash
# Pinned
curl -fsSL "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.sh"| bash -s -- --version v0.2.5 --force
irm "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.ps1"| iex
Install-Tollbit-Version latest -Force
Other channels:
  • npm: npm update -g @tollbit/tollbit-cli
Assumptions
  • Gateway API base URL defaults to https://gateway.tollbit.com (agent search).
  • Agent identity tokens are minted via the auth service (TOLLBIT_AUTH_BASE_URL).
Configure
Agent credentials are stored under TOLLBIT_CREDENTIALS_STORAGE_DIR (default platform path): agent-identity.json and agent-token.jwt.
License
MIT — see LICENSE. Binary distributions include third-party license notices in THIRD-PARTY-NOTICES.md.
About
Search and fetch licensed publisher content for AI agents on the TollBit network.
tollbit.com
Topics
ai-agentsclicontent-licensinggolangllmragtollbit
Resources
Readme
MIT license
Contributing
Contributing
Activity
Custom properties
Stars
0 stars
Watchers
2 watching
Forks
0 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix");
}
} catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation
Tollbit CLI
CLI client for searching and grounding content for agents, allows access to all content in the TollBit network.
Binaries and installers are published on GitHub Releases.
Primary workflow: install → search → content pricing → content fetch. Authentication is triggered automatically by the CLI when needed.
Install
Agent install prompt
Agent?: Install Tollbit from github.com/tollbit/cli using the install script or package that your environment needs (below), then run tollbit guide --install <SKILLS_DIR> to register the bundled skill.
macOS and Linux
curl -fsSL "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.sh"| bash
Pin a version or choose an install directory:
curl -fsSL "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.sh"| bash -s -- --version v0.2.5
curl -fsSL "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.sh"| bash -s -- --install-dir "$HOME/bin" --force
By default the binary goes under ~/.local/bin; the installer can add that directory to your shell PATH. Use --no-modify-path to skip PATH changes in CI or locked environments.
Windows (PowerShell)
irm "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.ps1"| iex
Pin a version or skip PATH changes (useful in CI):
irm "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.ps1"| iex
Install-Tollbit-Version v0.2.5-Force
Install-Tollbit-NoModifyPath -PrintPathInstructions
npm
npm install -g @tollbit/tollbit-cli
Then run tollbit from any terminal (the package downloads the native binary for your OS).
Manual install
From GitHub Releases, download the archive for your OS and CPU, verify SHA-256 against tollbit_<version>_checksums.txt, and put tollbit (or tollbit.exe) on your PATH.
Build from source
go build ./cmd/tollbit
See CONTRIBUTING.md for local development and release instructions.
For AI coding agents
  • Install tollbit so it is on PATH in every environment where you run shell commands (CI images, local sandboxes, agent runners).
  • Run tollbit guide for orientation, then tollbit guide --install <SKILLS_DIR> to persist the bundled skill. The guide is the full automation contract (exit codes, streams, non-interactive fetch).
  • Typical flow: search → content pricing → content fetch. The CLI prompts for authentication when a token is required.
  • Optionally set an agent profile with tollbit auth set --name <name> (or TOLLBIT_AGENT_DEFAULT_NAME) / --user-agent.
  • Prefer --json on search, content pricing, content fetch, feedback, and auth status. Exit codes: 0 success, 1 runtime, 2 usage; stdout is data-only (hints and errors on stderr).
What the CLI can do
CommandPurpose
search "query"Search publisher content via the gateway API.
content pricing/fetchPrice and fetch licensed publisher content.
feedback "message"Submit CLI / agent feedback (requires OBO).
auth login/logout/status/setAgent profile and OAuth authorization token (also run automatically when needed).
guidePrint the agent guide; optionally install bundled skill markdown.
versionPrint the CLI version string.
Typical flow: search "query" → content pricing <url> → content fetch <url>. Use --help on each command for flags.
Commands
Search
Search first; the CLI will prompt for authentication if your session is not ready yet.
tollbit search "climate policy"
tollbit search "climate policy" --size 10 --json
tollbit search "query" --properties example.com,cnn.com --programmatic-only
Content
Price and fetch licensed publisher content:
tollbit content pricing https://example.com/article-1,https://example.com/article-2
tollbit content pricing https://example.com/article --json
tollbit content fetch https://example.com/article
tollbit content fetch https://example.com/article --confirm --toDisk ./article.md
tollbit content fetch https://example.com/article --confirm --json --rate-index 1
Every fetch charges money. Pricing is shown and you must confirm unless you pass --confirm (automation still incurs cost). Use --toDisk=<path> to save fetched content locally. When no user agent is configured, the org default -tbcli- agent is used. Set a registered user agent with auth set --user-agent or --user-agent on the fetch command.
Feedback
Submit product feedback (requires an OBO-linked agent session):
tollbit feedback "search ranking felt off for this query"
tollbit feedback "great fetch UX" --rating 5 --category content
tollbit feedback "auth hung" --rating 2 --category auth --metadata source=cli --json
Auth
Auth runs automatically when a command needs a token. Use these commands to inspect or manage the profile explicitly:
tollbit auth login --name my-agent --user-agent MyAgent-User
tollbit auth status
tollbit auth status --json
tollbit auth status --check
tollbit auth set --name my-agent --user-agent MyAgent-User
tollbit auth logout
tollbit auth logout --all
Logging in again (tollbit auth login) mints a new token and revokes all previous ones — use it if you believe a token was exposed. auth logout revokes the current token; auth logout --force clears local credentials even if the server can't be reached (the token is then revoked at your next login or expires within 30 days).
TOLLBIT_AGENT_DEFAULT_NAME and TOLLBIT_AGENT_DEFAULT_USER_AGENT set fallback profile defaults. Saved profile overrides those defaults. search and content accept --user-agent as a per-request override.
auth status --check exits 0 when the token is valid, 1 when invalid/expired, and 2 when missing (no stdout).
Set TOLLBIT_AUTH_BROWSER_CONSENT_AUTO_OPEN_BROWSER=false in headless environments.
Guide
tollbit guide
tollbit guide --install ~/.claude/skills
Install writes <dir>/<skill-name>/SKILL.md (name from embedded frontmatter, e.g. tollbit-cli).
Version
tollbit version
tollbit --version
Compare to the version field in the embedded skill when deciding whether to refresh an installed skill.
Updating
Installer channel updates:
# Latest
curl -fsSL "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.sh"| bash
# Pinned
curl -fsSL "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.sh"| bash -s -- --version v0.2.5 --force
irm "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.ps1"| iex
Install-Tollbit-Version latest -Force
Other channels:
  • npm: npm update -g @tollbit/tollbit-cli
Assumptions
  • Gateway API base URL defaults to https://gateway.tollbit.com (agent search).
  • Agent identity tokens are minted via the auth service (TOLLBIT_AUTH_BASE_URL).
Configure
Agent credentials are stored under TOLLBIT_CREDENTIALS_STORAGE_DIR (default platform path): agent-identity.json and agent-token.jwt.
License
MIT — see LICENSE. Binary distributions include third-party license notices in THIRD-PARTY-NOTICES.md.
About
Search and fetch licensed publisher content for AI agents on the TollBit network.
tollbit.com
Topics
ai-agentsclicontent-licensinggolangllmragtollbit
Resources
Readme
MIT license
Contributing
Contributing
Activity
Custom properties
Stars
0 stars
Watchers
2 watching
Forks
0 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms");
}
} catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation
Tollbit CLI
CLI client for searching and grounding content for agents, allows access to all content in the TollBit network.
Binaries and installers are published on GitHub Releases.
Primary workflow: install → search → content pricing → content fetch. Authentication is triggered automatically by the CLI when needed.
Install
Agent install prompt
Agent?: Install Tollbit from github.com/tollbit/cli using the install script or package that your environment needs (below), then run tollbit guide --install <SKILLS_DIR> to register the bundled skill.
macOS and Linux
curl -fsSL "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.sh"| bash
Pin a version or choose an install directory:
curl -fsSL "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.sh"| bash -s -- --version v0.2.5
curl -fsSL "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.sh"| bash -s -- --install-dir "$HOME/bin" --force
By default the binary goes under ~/.local/bin; the installer can add that directory to your shell PATH. Use --no-modify-path to skip PATH changes in CI or locked environments.
Windows (PowerShell)
irm "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.ps1"| iex
Pin a version or skip PATH changes (useful in CI):
irm "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.ps1"| iex
Install-Tollbit-Version v0.2.5-Force
Install-Tollbit-NoModifyPath -PrintPathInstructions
npm
npm install -g @tollbit/tollbit-cli
Then run tollbit from any terminal (the package downloads the native binary for your OS).
Manual install
From GitHub Releases, download the archive for your OS and CPU, verify SHA-256 against tollbit_<version>_checksums.txt, and put tollbit (or tollbit.exe) on your PATH.
Build from source
go build ./cmd/tollbit
See CONTRIBUTING.md for local development and release instructions.
For AI coding agents
  • Install tollbit so it is on PATH in every environment where you run shell commands (CI images, local sandboxes, agent runners).
  • Run tollbit guide for orientation, then tollbit guide --install <SKILLS_DIR> to persist the bundled skill. The guide is the full automation contract (exit codes, streams, non-interactive fetch).
  • Typical flow: search → content pricing → content fetch. The CLI prompts for authentication when a token is required.
  • Optionally set an agent profile with tollbit auth set --name <name> (or TOLLBIT_AGENT_DEFAULT_NAME) / --user-agent.
  • Prefer --json on search, content pricing, content fetch, feedback, and auth status. Exit codes: 0 success, 1 runtime, 2 usage; stdout is data-only (hints and errors on stderr).
What the CLI can do
CommandPurpose
search "query"Search publisher content via the gateway API.
content pricing/fetchPrice and fetch licensed publisher content.
feedback "message"Submit CLI / agent feedback (requires OBO).
auth login/logout/status/setAgent profile and OAuth authorization token (also run automatically when needed).
guidePrint the agent guide; optionally install bundled skill markdown.
versionPrint the CLI version string.
Typical flow: search "query" → content pricing <url> → content fetch <url>. Use --help on each command for flags.
Commands
Search
Search first; the CLI will prompt for authentication if your session is not ready yet.
tollbit search "climate policy"
tollbit search "climate policy" --size 10 --json
tollbit search "query" --properties example.com,cnn.com --programmatic-only
Content
Price and fetch licensed publisher content:
tollbit content pricing https://example.com/article-1,https://example.com/article-2
tollbit content pricing https://example.com/article --json
tollbit content fetch https://example.com/article
tollbit content fetch https://example.com/article --confirm --toDisk ./article.md
tollbit content fetch https://example.com/article --confirm --json --rate-index 1
Every fetch charges money. Pricing is shown and you must confirm unless you pass --confirm (automation still incurs cost). Use --toDisk=<path> to save fetched content locally. When no user agent is configured, the org default -tbcli- agent is used. Set a registered user agent with auth set --user-agent or --user-agent on the fetch command.
Feedback
Submit product feedback (requires an OBO-linked agent session):
tollbit feedback "search ranking felt off for this query"
tollbit feedback "great fetch UX" --rating 5 --category content
tollbit feedback "auth hung" --rating 2 --category auth --metadata source=cli --json
Auth
Auth runs automatically when a command needs a token. Use these commands to inspect or manage the profile explicitly:
tollbit auth login --name my-agent --user-agent MyAgent-User
tollbit auth status
tollbit auth status --json
tollbit auth status --check
tollbit auth set --name my-agent --user-agent MyAgent-User
tollbit auth logout
tollbit auth logout --all
Logging in again (tollbit auth login) mints a new token and revokes all previous ones — use it if you believe a token was exposed. auth logout revokes the current token; auth logout --force clears local credentials even if the server can't be reached (the token is then revoked at your next login or expires within 30 days).
TOLLBIT_AGENT_DEFAULT_NAME and TOLLBIT_AGENT_DEFAULT_USER_AGENT set fallback profile defaults. Saved profile overrides those defaults. search and content accept --user-agent as a per-request override.
auth status --check exits 0 when the token is valid, 1 when invalid/expired, and 2 when missing (no stdout).
Set TOLLBIT_AUTH_BROWSER_CONSENT_AUTO_OPEN_BROWSER=false in headless environments.
Guide
tollbit guide
tollbit guide --install ~/.claude/skills
Install writes <dir>/<skill-name>/SKILL.md (name from embedded frontmatter, e.g. tollbit-cli).
Version
tollbit version
tollbit --version
Compare to the version field in the embedded skill when deciding whether to refresh an installed skill.
Updating
Installer channel updates:
# Latest
curl -fsSL "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.sh"| bash
# Pinned
curl -fsSL "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.sh"| bash -s -- --version v0.2.5 --force
irm "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.ps1"| iex
Install-Tollbit-Version latest -Force
Other channels:
  • npm: npm update -g @tollbit/tollbit-cli
Assumptions
  • Gateway API base URL defaults to https://gateway.tollbit.com (agent search).
  • Agent identity tokens are minted via the auth service (TOLLBIT_AUTH_BASE_URL).
Configure
Agent credentials are stored under TOLLBIT_CREDENTIALS_STORAGE_DIR (default platform path): agent-identity.json and agent-token.jwt.
License
MIT — see LICENSE. Binary distributions include third-party license notices in THIRD-PARTY-NOTICES.md.
About
Search and fetch licensed publisher content for AI agents on the TollBit network.
tollbit.com
Topics
ai-agentsclicontent-licensinggolangllmragtollbit
Resources
Readme
MIT license
Contributing
Contributing
Activity
Custom properties
Stars
0 stars
Watchers
2 watching
Forks
0 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links");
}
} catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); }
})();
(function(){
try {
var __m = "youtube.com";
var __re = new RegExp('^' + "youtube\\.com" + '

Skip to content
BranchesTags
Repository files navigation
Tollbit CLI
CLI client for searching and grounding content for agents, allows access to all content in the TollBit network.
Binaries and installers are published on GitHub Releases.
Primary workflow: install → search → content pricing → content fetch. Authentication is triggered automatically by the CLI when needed.
Install
Agent install prompt
Agent?: Install Tollbit from github.com/tollbit/cli using the install script or package that your environment needs (below), then run tollbit guide --install <SKILLS_DIR> to register the bundled skill.
macOS and Linux
curl -fsSL "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.sh"| bash
Pin a version or choose an install directory:
curl -fsSL "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.sh"| bash -s -- --version v0.2.5
curl -fsSL "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.sh"| bash -s -- --install-dir "$HOME/bin" --force
By default the binary goes under ~/.local/bin; the installer can add that directory to your shell PATH. Use --no-modify-path to skip PATH changes in CI or locked environments.
Windows (PowerShell)
irm "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.ps1"| iex
Pin a version or skip PATH changes (useful in CI):
irm "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.ps1"| iex
Install-Tollbit-Version v0.2.5-Force
Install-Tollbit-NoModifyPath -PrintPathInstructions
npm
npm install -g @tollbit/tollbit-cli
Then run tollbit from any terminal (the package downloads the native binary for your OS).
Manual install
From GitHub Releases, download the archive for your OS and CPU, verify SHA-256 against tollbit_<version>_checksums.txt, and put tollbit (or tollbit.exe) on your PATH.
Build from source
go build ./cmd/tollbit
See CONTRIBUTING.md for local development and release instructions.
For AI coding agents
  • Install tollbit so it is on PATH in every environment where you run shell commands (CI images, local sandboxes, agent runners).
  • Run tollbit guide for orientation, then tollbit guide --install <SKILLS_DIR> to persist the bundled skill. The guide is the full automation contract (exit codes, streams, non-interactive fetch).
  • Typical flow: search → content pricing → content fetch. The CLI prompts for authentication when a token is required.
  • Optionally set an agent profile with tollbit auth set --name <name> (or TOLLBIT_AGENT_DEFAULT_NAME) / --user-agent.
  • Prefer --json on search, content pricing, content fetch, feedback, and auth status. Exit codes: 0 success, 1 runtime, 2 usage; stdout is data-only (hints and errors on stderr).
What the CLI can do
CommandPurpose
search "query"Search publisher content via the gateway API.
content pricing/fetchPrice and fetch licensed publisher content.
feedback "message"Submit CLI / agent feedback (requires OBO).
auth login/logout/status/setAgent profile and OAuth authorization token (also run automatically when needed).
guidePrint the agent guide; optionally install bundled skill markdown.
versionPrint the CLI version string.
Typical flow: search "query" → content pricing <url> → content fetch <url>. Use --help on each command for flags.
Commands
Search
Search first; the CLI will prompt for authentication if your session is not ready yet.
tollbit search "climate policy"
tollbit search "climate policy" --size 10 --json
tollbit search "query" --properties example.com,cnn.com --programmatic-only
Content
Price and fetch licensed publisher content:
tollbit content pricing https://example.com/article-1,https://example.com/article-2
tollbit content pricing https://example.com/article --json
tollbit content fetch https://example.com/article
tollbit content fetch https://example.com/article --confirm --toDisk ./article.md
tollbit content fetch https://example.com/article --confirm --json --rate-index 1
Every fetch charges money. Pricing is shown and you must confirm unless you pass --confirm (automation still incurs cost). Use --toDisk=<path> to save fetched content locally. When no user agent is configured, the org default -tbcli- agent is used. Set a registered user agent with auth set --user-agent or --user-agent on the fetch command.
Feedback
Submit product feedback (requires an OBO-linked agent session):
tollbit feedback "search ranking felt off for this query"
tollbit feedback "great fetch UX" --rating 5 --category content
tollbit feedback "auth hung" --rating 2 --category auth --metadata source=cli --json
Auth
Auth runs automatically when a command needs a token. Use these commands to inspect or manage the profile explicitly:
tollbit auth login --name my-agent --user-agent MyAgent-User
tollbit auth status
tollbit auth status --json
tollbit auth status --check
tollbit auth set --name my-agent --user-agent MyAgent-User
tollbit auth logout
tollbit auth logout --all
Logging in again (tollbit auth login) mints a new token and revokes all previous ones — use it if you believe a token was exposed. auth logout revokes the current token; auth logout --force clears local credentials even if the server can't be reached (the token is then revoked at your next login or expires within 30 days).
TOLLBIT_AGENT_DEFAULT_NAME and TOLLBIT_AGENT_DEFAULT_USER_AGENT set fallback profile defaults. Saved profile overrides those defaults. search and content accept --user-agent as a per-request override.
auth status --check exits 0 when the token is valid, 1 when invalid/expired, and 2 when missing (no stdout).
Set TOLLBIT_AUTH_BROWSER_CONSENT_AUTO_OPEN_BROWSER=false in headless environments.
Guide
tollbit guide
tollbit guide --install ~/.claude/skills
Install writes <dir>/<skill-name>/SKILL.md (name from embedded frontmatter, e.g. tollbit-cli).
Version
tollbit version
tollbit --version
Compare to the version field in the embedded skill when deciding whether to refresh an installed skill.
Updating
Installer channel updates:
# Latest
curl -fsSL "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.sh"| bash
# Pinned
curl -fsSL "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.sh"| bash -s -- --version v0.2.5 --force
irm "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.ps1"| iex
Install-Tollbit-Version latest -Force
Other channels:
  • npm: npm update -g @tollbit/tollbit-cli
Assumptions
  • Gateway API base URL defaults to https://gateway.tollbit.com (agent search).
  • Agent identity tokens are minted via the auth service (TOLLBIT_AUTH_BASE_URL).
Configure
Agent credentials are stored under TOLLBIT_CREDENTIALS_STORAGE_DIR (default platform path): agent-identity.json and agent-token.jwt.
License
MIT — see LICENSE. Binary distributions include third-party license notices in THIRD-PARTY-NOTICES.md.
About
Search and fetch licensed publisher content for AI agents on the TollBit network.
tollbit.com
Topics
ai-agentsclicontent-licensinggolangllmragtollbit
Resources
Readme
MIT license
Contributing
Contributing
Activity
Custom properties
Stars
0 stars
Watchers
2 watching
Forks
0 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default");
}
} catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation
Tollbit CLI
CLI client for searching and grounding content for agents, allows access to all content in the TollBit network.
Binaries and installers are published on GitHub Releases.
Primary workflow: install → search → content pricing → content fetch. Authentication is triggered automatically by the CLI when needed.
Install
Agent install prompt
Agent?: Install Tollbit from github.com/tollbit/cli using the install script or package that your environment needs (below), then run tollbit guide --install <SKILLS_DIR> to register the bundled skill.
macOS and Linux
curl -fsSL "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.sh"| bash
Pin a version or choose an install directory:
curl -fsSL "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.sh"| bash -s -- --version v0.2.5
curl -fsSL "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.sh"| bash -s -- --install-dir "$HOME/bin" --force
By default the binary goes under ~/.local/bin; the installer can add that directory to your shell PATH. Use --no-modify-path to skip PATH changes in CI or locked environments.
Windows (PowerShell)
irm "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.ps1"| iex
Pin a version or skip PATH changes (useful in CI):
irm "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.ps1"| iex
Install-Tollbit-Version v0.2.5-Force
Install-Tollbit-NoModifyPath -PrintPathInstructions
npm
npm install -g @tollbit/tollbit-cli
Then run tollbit from any terminal (the package downloads the native binary for your OS).
Manual install
From GitHub Releases, download the archive for your OS and CPU, verify SHA-256 against tollbit_<version>_checksums.txt, and put tollbit (or tollbit.exe) on your PATH.
Build from source
go build ./cmd/tollbit
See CONTRIBUTING.md for local development and release instructions.
For AI coding agents
  • Install tollbit so it is on PATH in every environment where you run shell commands (CI images, local sandboxes, agent runners).
  • Run tollbit guide for orientation, then tollbit guide --install <SKILLS_DIR> to persist the bundled skill. The guide is the full automation contract (exit codes, streams, non-interactive fetch).
  • Typical flow: search → content pricing → content fetch. The CLI prompts for authentication when a token is required.
  • Optionally set an agent profile with tollbit auth set --name <name> (or TOLLBIT_AGENT_DEFAULT_NAME) / --user-agent.
  • Prefer --json on search, content pricing, content fetch, feedback, and auth status. Exit codes: 0 success, 1 runtime, 2 usage; stdout is data-only (hints and errors on stderr).
What the CLI can do
CommandPurpose
search "query"Search publisher content via the gateway API.
content pricing/fetchPrice and fetch licensed publisher content.
feedback "message"Submit CLI / agent feedback (requires OBO).
auth login/logout/status/setAgent profile and OAuth authorization token (also run automatically when needed).
guidePrint the agent guide; optionally install bundled skill markdown.
versionPrint the CLI version string.
Typical flow: search "query" → content pricing <url> → content fetch <url>. Use --help on each command for flags.
Commands
Search
Search first; the CLI will prompt for authentication if your session is not ready yet.
tollbit search "climate policy"
tollbit search "climate policy" --size 10 --json
tollbit search "query" --properties example.com,cnn.com --programmatic-only
Content
Price and fetch licensed publisher content:
tollbit content pricing https://example.com/article-1,https://example.com/article-2
tollbit content pricing https://example.com/article --json
tollbit content fetch https://example.com/article
tollbit content fetch https://example.com/article --confirm --toDisk ./article.md
tollbit content fetch https://example.com/article --confirm --json --rate-index 1
Every fetch charges money. Pricing is shown and you must confirm unless you pass --confirm (automation still incurs cost). Use --toDisk=<path> to save fetched content locally. When no user agent is configured, the org default -tbcli- agent is used. Set a registered user agent with auth set --user-agent or --user-agent on the fetch command.
Feedback
Submit product feedback (requires an OBO-linked agent session):
tollbit feedback "search ranking felt off for this query"
tollbit feedback "great fetch UX" --rating 5 --category content
tollbit feedback "auth hung" --rating 2 --category auth --metadata source=cli --json
Auth
Auth runs automatically when a command needs a token. Use these commands to inspect or manage the profile explicitly:
tollbit auth login --name my-agent --user-agent MyAgent-User
tollbit auth status
tollbit auth status --json
tollbit auth status --check
tollbit auth set --name my-agent --user-agent MyAgent-User
tollbit auth logout
tollbit auth logout --all
Logging in again (tollbit auth login) mints a new token and revokes all previous ones — use it if you believe a token was exposed. auth logout revokes the current token; auth logout --force clears local credentials even if the server can't be reached (the token is then revoked at your next login or expires within 30 days).
TOLLBIT_AGENT_DEFAULT_NAME and TOLLBIT_AGENT_DEFAULT_USER_AGENT set fallback profile defaults. Saved profile overrides those defaults. search and content accept --user-agent as a per-request override.
auth status --check exits 0 when the token is valid, 1 when invalid/expired, and 2 when missing (no stdout).
Set TOLLBIT_AUTH_BROWSER_CONSENT_AUTO_OPEN_BROWSER=false in headless environments.
Guide
tollbit guide
tollbit guide --install ~/.claude/skills
Install writes <dir>/<skill-name>/SKILL.md (name from embedded frontmatter, e.g. tollbit-cli).
Version
tollbit version
tollbit --version
Compare to the version field in the embedded skill when deciding whether to refresh an installed skill.
Updating
Installer channel updates:
# Latest
curl -fsSL "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.sh"| bash
# Pinned
curl -fsSL "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.sh"| bash -s -- --version v0.2.5 --force
irm "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.ps1"| iex
Install-Tollbit-Version latest -Force
Other channels:
  • npm: npm update -g @tollbit/tollbit-cli
Assumptions
  • Gateway API base URL defaults to https://gateway.tollbit.com (agent search).
  • Agent identity tokens are minted via the auth service (TOLLBIT_AUTH_BASE_URL).
Configure
Agent credentials are stored under TOLLBIT_CREDENTIALS_STORAGE_DIR (default platform path): agent-identity.json and agent-token.jwt.
License
MIT — see LICENSE. Binary distributions include third-party license notices in THIRD-PARTY-NOTICES.md.
About
Search and fetch licensed publisher content for AI agents on the TollBit network.
tollbit.com
Topics
ai-agentsclicontent-licensinggolangllmragtollbit
Resources
Readme
MIT license
Contributing
Contributing
Activity
Custom properties
Stars
0 stars
Watchers
2 watching
Forks
0 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers");
}
} catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation
Tollbit CLI
CLI client for searching and grounding content for agents, allows access to all content in the TollBit network.
Binaries and installers are published on GitHub Releases.
Primary workflow: install → search → content pricing → content fetch. Authentication is triggered automatically by the CLI when needed.
Install
Agent install prompt
Agent?: Install Tollbit from github.com/tollbit/cli using the install script or package that your environment needs (below), then run tollbit guide --install <SKILLS_DIR> to register the bundled skill.
macOS and Linux
curl -fsSL "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.sh"| bash
Pin a version or choose an install directory:
curl -fsSL "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.sh"| bash -s -- --version v0.2.5
curl -fsSL "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.sh"| bash -s -- --install-dir "$HOME/bin" --force
By default the binary goes under ~/.local/bin; the installer can add that directory to your shell PATH. Use --no-modify-path to skip PATH changes in CI or locked environments.
Windows (PowerShell)
irm "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.ps1"| iex
Pin a version or skip PATH changes (useful in CI):
irm "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.ps1"| iex
Install-Tollbit-Version v0.2.5-Force
Install-Tollbit-NoModifyPath -PrintPathInstructions
npm
npm install -g @tollbit/tollbit-cli
Then run tollbit from any terminal (the package downloads the native binary for your OS).
Manual install
From GitHub Releases, download the archive for your OS and CPU, verify SHA-256 against tollbit_<version>_checksums.txt, and put tollbit (or tollbit.exe) on your PATH.
Build from source
go build ./cmd/tollbit
See CONTRIBUTING.md for local development and release instructions.
For AI coding agents
  • Install tollbit so it is on PATH in every environment where you run shell commands (CI images, local sandboxes, agent runners).
  • Run tollbit guide for orientation, then tollbit guide --install <SKILLS_DIR> to persist the bundled skill. The guide is the full automation contract (exit codes, streams, non-interactive fetch).
  • Typical flow: search → content pricing → content fetch. The CLI prompts for authentication when a token is required.
  • Optionally set an agent profile with tollbit auth set --name <name> (or TOLLBIT_AGENT_DEFAULT_NAME) / --user-agent.
  • Prefer --json on search, content pricing, content fetch, feedback, and auth status. Exit codes: 0 success, 1 runtime, 2 usage; stdout is data-only (hints and errors on stderr).
What the CLI can do
CommandPurpose
search "query"Search publisher content via the gateway API.
content pricing/fetchPrice and fetch licensed publisher content.
feedback "message"Submit CLI / agent feedback (requires OBO).
auth login/logout/status/setAgent profile and OAuth authorization token (also run automatically when needed).
guidePrint the agent guide; optionally install bundled skill markdown.
versionPrint the CLI version string.
Typical flow: search "query" → content pricing <url> → content fetch <url>. Use --help on each command for flags.
Commands
Search
Search first; the CLI will prompt for authentication if your session is not ready yet.
tollbit search "climate policy"
tollbit search "climate policy" --size 10 --json
tollbit search "query" --properties example.com,cnn.com --programmatic-only
Content
Price and fetch licensed publisher content:
tollbit content pricing https://example.com/article-1,https://example.com/article-2
tollbit content pricing https://example.com/article --json
tollbit content fetch https://example.com/article
tollbit content fetch https://example.com/article --confirm --toDisk ./article.md
tollbit content fetch https://example.com/article --confirm --json --rate-index 1
Every fetch charges money. Pricing is shown and you must confirm unless you pass --confirm (automation still incurs cost). Use --toDisk=<path> to save fetched content locally. When no user agent is configured, the org default -tbcli- agent is used. Set a registered user agent with auth set --user-agent or --user-agent on the fetch command.
Feedback
Submit product feedback (requires an OBO-linked agent session):
tollbit feedback "search ranking felt off for this query"
tollbit feedback "great fetch UX" --rating 5 --category content
tollbit feedback "auth hung" --rating 2 --category auth --metadata source=cli --json
Auth
Auth runs automatically when a command needs a token. Use these commands to inspect or manage the profile explicitly:
tollbit auth login --name my-agent --user-agent MyAgent-User
tollbit auth status
tollbit auth status --json
tollbit auth status --check
tollbit auth set --name my-agent --user-agent MyAgent-User
tollbit auth logout
tollbit auth logout --all
Logging in again (tollbit auth login) mints a new token and revokes all previous ones — use it if you believe a token was exposed. auth logout revokes the current token; auth logout --force clears local credentials even if the server can't be reached (the token is then revoked at your next login or expires within 30 days).
TOLLBIT_AGENT_DEFAULT_NAME and TOLLBIT_AGENT_DEFAULT_USER_AGENT set fallback profile defaults. Saved profile overrides those defaults. search and content accept --user-agent as a per-request override.
auth status --check exits 0 when the token is valid, 1 when invalid/expired, and 2 when missing (no stdout).
Set TOLLBIT_AUTH_BROWSER_CONSENT_AUTO_OPEN_BROWSER=false in headless environments.
Guide
tollbit guide
tollbit guide --install ~/.claude/skills
Install writes <dir>/<skill-name>/SKILL.md (name from embedded frontmatter, e.g. tollbit-cli).
Version
tollbit version
tollbit --version
Compare to the version field in the embedded skill when deciding whether to refresh an installed skill.
Updating
Installer channel updates:
# Latest
curl -fsSL "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.sh"| bash
# Pinned
curl -fsSL "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.sh"| bash -s -- --version v0.2.5 --force
irm "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.ps1"| iex
Install-Tollbit-Version latest -Force
Other channels:
  • npm: npm update -g @tollbit/tollbit-cli
Assumptions
  • Gateway API base URL defaults to https://gateway.tollbit.com (agent search).
  • Agent identity tokens are minted via the auth service (TOLLBIT_AUTH_BASE_URL).
Configure
Agent credentials are stored under TOLLBIT_CREDENTIALS_STORAGE_DIR (default platform path): agent-identity.json and agent-token.jwt.
License
MIT — see LICENSE. Binary distributions include third-party license notices in THIRD-PARTY-NOTICES.md.
About
Search and fetch licensed publisher content for AI agents on the TollBit network.
tollbit.com
Topics
ai-agentsclicontent-licensinggolangllmragtollbit
Resources
Readme
MIT license
Contributing
Contributing
Activity
Custom properties
Stars
0 stars
Watchers
2 watching
Forks
0 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode");
}
} catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); }
})();
})();

Skip to content
BranchesTags
Repository files navigation
Tollbit CLI
CLI client for searching and grounding content for agents, allows access to all content in the TollBit network.
Binaries and installers are published on GitHub Releases.
Primary workflow: install → search → content pricing → content fetch. Authentication is triggered automatically by the CLI when needed.
Install
Agent install prompt
Agent?: Install Tollbit from github.com/tollbit/cli using the install script or package that your environment needs (below), then run tollbit guide --install <SKILLS_DIR> to register the bundled skill.
macOS and Linux
curl -fsSL "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.sh"| bash
Pin a version or choose an install directory:
curl -fsSL "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.sh"| bash -s -- --version v0.2.5
curl -fsSL "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.sh"| bash -s -- --install-dir "$HOME/bin" --force
By default the binary goes under ~/.local/bin; the installer can add that directory to your shell PATH. Use --no-modify-path to skip PATH changes in CI or locked environments.
Windows (PowerShell)
irm "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.ps1"| iex
Pin a version or skip PATH changes (useful in CI):
irm "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.ps1"| iex
Install-Tollbit-Version v0.2.5-Force
Install-Tollbit-NoModifyPath -PrintPathInstructions
npm
npm install -g @tollbit/tollbit-cli
Then run tollbit from any terminal (the package downloads the native binary for your OS).
Manual install
From GitHub Releases, download the archive for your OS and CPU, verify SHA-256 against tollbit_<version>_checksums.txt, and put tollbit (or tollbit.exe) on your PATH.
Build from source
go build ./cmd/tollbit
See CONTRIBUTING.md for local development and release instructions.
For AI coding agents
  • Install tollbit so it is on PATH in every environment where you run shell commands (CI images, local sandboxes, agent runners).
  • Run tollbit guide for orientation, then tollbit guide --install <SKILLS_DIR> to persist the bundled skill. The guide is the full automation contract (exit codes, streams, non-interactive fetch).
  • Typical flow: search → content pricing → content fetch. The CLI prompts for authentication when a token is required.
  • Optionally set an agent profile with tollbit auth set --name <name> (or TOLLBIT_AGENT_DEFAULT_NAME) / --user-agent.
  • Prefer --json on search, content pricing, content fetch, feedback, and auth status. Exit codes: 0 success, 1 runtime, 2 usage; stdout is data-only (hints and errors on stderr).
What the CLI can do
CommandPurpose
search "query"Search publisher content via the gateway API.
content pricing/fetchPrice and fetch licensed publisher content.
feedback "message"Submit CLI / agent feedback (requires OBO).
auth login/logout/status/setAgent profile and OAuth authorization token (also run automatically when needed).
guidePrint the agent guide; optionally install bundled skill markdown.
versionPrint the CLI version string.
Typical flow: search "query" → content pricing <url> → content fetch <url>. Use --help on each command for flags.
Commands
Search
Search first; the CLI will prompt for authentication if your session is not ready yet.
tollbit search "climate policy"
tollbit search "climate policy" --size 10 --json
tollbit search "query" --properties example.com,cnn.com --programmatic-only
Content
Price and fetch licensed publisher content:
tollbit content pricing https://example.com/article-1,https://example.com/article-2
tollbit content pricing https://example.com/article --json
tollbit content fetch https://example.com/article
tollbit content fetch https://example.com/article --confirm --toDisk ./article.md
tollbit content fetch https://example.com/article --confirm --json --rate-index 1
Every fetch charges money. Pricing is shown and you must confirm unless you pass --confirm (automation still incurs cost). Use --toDisk=<path> to save fetched content locally. When no user agent is configured, the org default -tbcli- agent is used. Set a registered user agent with auth set --user-agent or --user-agent on the fetch command.
Feedback
Submit product feedback (requires an OBO-linked agent session):
tollbit feedback "search ranking felt off for this query"
tollbit feedback "great fetch UX" --rating 5 --category content
tollbit feedback "auth hung" --rating 2 --category auth --metadata source=cli --json
Auth
Auth runs automatically when a command needs a token. Use these commands to inspect or manage the profile explicitly:
tollbit auth login --name my-agent --user-agent MyAgent-User
tollbit auth status
tollbit auth status --json
tollbit auth status --check
tollbit auth set --name my-agent --user-agent MyAgent-User
tollbit auth logout
tollbit auth logout --all
Logging in again (tollbit auth login) mints a new token and revokes all previous ones — use it if you believe a token was exposed. auth logout revokes the current token; auth logout --force clears local credentials even if the server can't be reached (the token is then revoked at your next login or expires within 30 days).
TOLLBIT_AGENT_DEFAULT_NAME and TOLLBIT_AGENT_DEFAULT_USER_AGENT set fallback profile defaults. Saved profile overrides those defaults. search and content accept --user-agent as a per-request override.
auth status --check exits 0 when the token is valid, 1 when invalid/expired, and 2 when missing (no stdout).
Set TOLLBIT_AUTH_BROWSER_CONSENT_AUTO_OPEN_BROWSER=false in headless environments.
Guide
tollbit guide
tollbit guide --install ~/.claude/skills
Install writes <dir>/<skill-name>/SKILL.md (name from embedded frontmatter, e.g. tollbit-cli).
Version
tollbit version
tollbit --version
Compare to the version field in the embedded skill when deciding whether to refresh an installed skill.
Updating
Installer channel updates:
# Latest
curl -fsSL "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.sh"| bash
# Pinned
curl -fsSL "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.sh"| bash -s -- --version v0.2.5 --force
irm "https://raw.githubusercontent.com/tollbit/cli/main/scripts/install.ps1"| iex
Install-Tollbit-Version latest -Force
Other channels:
  • npm: npm update -g @tollbit/tollbit-cli
Assumptions
  • Gateway API base URL defaults to https://gateway.tollbit.com (agent search).
  • Agent identity tokens are minted via the auth service (TOLLBIT_AUTH_BASE_URL).
Configure
Agent credentials are stored under TOLLBIT_CREDENTIALS_STORAGE_DIR (default platform path): agent-identity.json and agent-token.jwt.
License
MIT — see LICENSE. Binary distributions include third-party license notices in THIRD-PARTY-NOTICES.md.
About
Search and fetch licensed publisher content for AI agents on the TollBit network.
tollbit.com
Topics
ai-agentsclicontent-licensinggolangllmragtollbit
Resources
Readme
MIT license
Contributing
Contributing
Activity
Custom properties
Stars
0 stars
Watchers
2 watching
Forks
0 forks
Report repository
Releases
Packages
Used by
Contributors
Languages