Curious — the curiosity agent

Curious doesn't wait to be asked. It scans its environment for knowledge gaps — missing docs, missing tests, unfamiliar files, undocumented modules — and seeks the information proactively. Unlike contextink (which acquires context when asked), curious finds gaps on its own and goes and gets the answer.

The word is coined: curious — the rung where the agent stops waiting and starts seeking.

        .----.
       /  _   \
       |=[_]==|
  (`.--.____.---.'\
   `-./'\\_.'
      |  /.  .||
       \:-: .'
  LGB   `-'                     (archive piece, credited, until the portrait lands)

What it does

| You say | Curious does | |---|---| | scan [path] | scans a repo for knowledge gaps (missing docs, tests, unfamiliar files, undocumented modules) | | gaps | lists detected gaps ranked by priority | | seek <target> | seeks info about a target (reads the file, extracts the fact) | | learn <fact> | records a learned fact | | status | shows what's known vs unknown | | ask tides: what are the tides? | forwards to a sibling over ACP, cited (and learns from the answer) |

Rules: gaps are detected by rules (missing README, no tests, unfamiliar extensions, no docstrings, too many deps). Seeking reads the file and extracts the first meaningful fact. Nothing is invented.

Run it

npm i -g curious-agent     # or: npx curious-agent  (packaged agent; needs python3)
curious-agent              # launches agents/curious/agent.py

Or from source:

git clone https://github.com/mrfentmen/curious && cd curious
python3 agents/curious/agent.py

For forwarded questions, point it at a checkout of the answerer repo:

AWESOME_SERVERS_HOME=/path/to/awesome-servers curious-agent

Run the tests (25 of them, offline, including real child-process federation):

python3 agents/curious/tests/test_agent.py

The honest parts

• Gaps are detected by rules, not by model opinion. A gap that can't be filled honestly is reported, not faked.
• Vendored lockwork is credited line by line: kit/ from the ACP kit; federation.py from the polymath — vendored on 2026-10-18, kept standalone on purpose.

Built on top of: mrfentmen/awesome-servers (the watcher runtime, the feeds) and mrfentmen/superagents (the polymath and the sentry, the first two agents this one borrows transport and lockwork from) and mrfentmen/fedora-hat and mrfentmen/instink and mrfentmen/contextink and mrfentmen/rewind and mrfentmen/scopink.