getctx.sh

The web, read
for agents.

getctx turns any URL, PDF or GitHub file into clean Markdown your agent can hold. When a page runs past its budget, it arrives as a table of contents. Your agent reads the section it needs, and turning to the next one is free.

$0.005
per credit
0 cr
to turn a page
free
status & price list
never
do credits expire
§ read the fold

Long pages arrive folded.

Most of a page is chrome, cookie banners and parts nobody asked about. getctx measures the page against your agent’s budget first. If it doesn’t fit, your agent gets a map instead of a flood, and opens only what it needs.

agent sessionbudget 8k tokens
you
Why is my loaf so dense? The guide I follow is at fieldnotes.example/sourdough.
readfieldnotes.example/sourdoughcharged
getctx
The page is 61,400 tokens, past your 8,000 budget. Here is its table of contents with section markers instead.
agent
Dense crumb is usually fermentation. Reading §4.
turn§4 Bulk fermentationfree
turn§7 Troubleshootingfree
agent
Your kitchen is cool, so a four-hour bulk ferment is too short. Give it six, until the dough has risen by half.
fieldnotes.example/sourdough
The Long Guide to Sourdough
page 61.4k
budget 8k

§7 Troubleshooting

Dense and gummy: under-fermented, or cut while hot. Flat and sour: over-fermented. Pale crust: not enough heat or steam.

page read 1turns 2 · cost 0
§ workflow seven steps

From first key to first page.

About four minutes, most of it spent choosing a pack. Nothing here needs a sales call.

  1. §101 / 07

    Sign up

    Open the console with Google or a code sent to your email. Your account starts at zero credits: no trial clock, no card on file, nothing to cancel.

    getctx
    Welcome to getctx

    Your organisation is ready.

    Organisationada’s workshop
    Balance0 credits
    Plannone. Pay per call.
  2. §202 / 07

    Create a key

    Name it after the agent that will hold it. One key per project, and any of them can be revoked in a click.

    getctx
    New API key

    Shown once. Copy it now.

    Nameclaude-code · laptop
    gctx_7f3a••••••••••••q9e2copied

    Keys belong to your organisation, never to one person.

  3. §303 / 07

    Hand it to your agent

    Claude Code, Codex, Cursor, or the agent you wrote yourself. Anything that can call a tool can call getctx. Paste the key once.

    getctx
    Connect an agent

    Pick where your agent lives.

    • Claude Code
    • Codex
    • Cursor
    • Your own

    # tell your agent once
    Use getctx whenever you need a web page, a PDF or a file from GitHub. Read the table of contents first; turn only to the sections you need.

  4. §404 / 07

    Ask what things cost

    The first call is the status call, and it is free. It returns your balance and every price, so your agent can plan before it spends a credit.

    getctx

    status · free

    0credits
    read a page1–2 cr
    turn to another sectionfree
    parse a PDF, per page1 cr
    search the web7 cr
    brand a domain10 cr
    statusfree
  5. §505 / 07

    Top up

    Buy a pack, or any amount from $5 to $5,000. The bigger packs carry up to 50% bonus credits, and credits never expire.

    getctx
    Add credits

    $0.005 a credit. Bonus on larger packs.

    $10
    2,000 cr
    +20%
    $50
    12,000 cr
    +50%
    $200
    60,000 cr

    Or any amount, $5 to $5,000. No subscription.

  6. §606 / 07

    Let it read

    Your agent reads pages, parses files, searches and watches. Long pages fold into sections, and turning between them costs nothing.

    getctx
    readdocs.example.dev/migrate-v4charged
    §1Before you start2.1k
    §2Install1.4k
    §3Breaking changes6.8k · free
    §4Config3.9k
    §5Rollback2.2k
  7. §707 / 07

    Watch the meter

    The console shows your balance, what each product used day by day, and when each key was last used. Top up when the balance runs low, or never again if the job is done.

    getctx
    Usage · last 30 days
    calls3,412
    credits used760
    balance11,240
§ agents where you already work

Built to be called, not clicked.

Your agent is the user. It checks the price list, reads the contents, turns to a section and moves on, without a person in the loop. Connect it once and it knows when to reach for getctx.

# Claude Code, with getctx connected
> Upgrade us to v4. The migration guide is at docs.example.dev/migrate-v4
⎿ getctx · status balance 12,000 · free
⎿ getctx · read docs.example.dev/migrate-v4
48,200 tokens. Table of contents: 9 sections.
⎿ getctx · turn §3 Breaking changes free
⎿ getctx · turn §4 Config free
Three breaking changes touch this repo. Starting with the config loader.
§ pricing per call

$0.005per credit. Every call has a listed price, and your agent sees it before the call runs.

See packs & prices
statusfree
read · fieldnotes.example/sourdoughquoted, then charged
turn · §4 Bulk fermentationfree
turn · §7 Troubleshootingfree
surprisesnone
no surprises · no subscriptionPriced first
§ principles the house rules

What we won’t charge you for.

  1. 01

    Turning a page.

    Once a long page is read, every other section of it is free to open.

  2. 02

    Looking at the menu.

    The status call returns your balance and every price, and costs nothing.

  3. 03

    Time passing.

    Credits never expire. There is no subscription to forget about.

  4. 04

    A surprise.

    Every call has a listed price your agent can see before it runs. No overage, and a read that fails costs nothing.

§ faq asked often

Questions, answered.

Anything else is in the Docs.

Your agent is ready to read.

Create a key, check the price list for free, then top up from $5.