Hivemind Sign in
Tools

Log tail

Tool Monitoring @dip497 0 installs

Follows a log file live: lines coloured by level, filtered by text or regular expression, and its errors handed to an agent.

hive plugins install @dip497/log-tail

Run it in a terminal, or find it in Hivemind under Settings ▸ Plugins.

OverviewInstallPermissionsVersions

Log tail

Follows a log file live: the newest lines, read again every 2 seconds, each coloured by its level: errors red, warnings a paler red (amber is the app's colour for what waits on you), info and debug quieter. The level comes from a level word (ERROR, WARN, level=info …) or, for JSON logs, the level field (words or numbers), and a JSON line is shown as its time, message and other fields. A stack trace's lines take the level of the error above them.

Filter by text, or by a regular expression written /like this/i; switch levels off and on, each with its count; pause to read, resume to follow. "Ask an agent about these errors" starts one in the tile's frame with the last 20 error lines (you read the prompt before it is sent). The field at the top changes the file for this tile; the setting is the default for new ones.

hive plugins install @dip497/log-tail
hive plugins enable @dip497/log-tail
hive plugins set @dip497/log-tail file logs/server.log
hive ctl open-tool @dip497/log-tail/tail

An agent asks it, while its tile is open:

hive ctl plugin call @dip497/log-tail errors
hive ctl plugin call @dip497/log-tail tail '{"lines":200,"filter":"/timeout|refused/i"}'

It asks for two permissions: start agents (workspace:spawn) and tell an agent something (workspace:prompt).

How it was made

Built by a coding agent (Claude) from the tool-plugin contract (the brief hive plugins new tool writes, and the tool plugin guide). It uses host.run of tail, useTileState for the file, filter and levels shown, and hm.commands.spawnAgent with the permissions above. Reading levels and filtering are in lib.js, tested on real log lines.

A tool arrives switched off. Turn it on in Settings ▸ Plugins, or with hive plugins enable @dip497/log-tail, if you trust who wrote it.

Files

From dip497/hivemind-plugins at fb488a4. Hivemind checks each file's checksum as it downloads, and stops if one changed.

  • hivemind-tool.jsonc77f49325d2f
  • icon.svgcf5d4201f013
  • index.jsdaaf2ef39b3d
  • lib.js81713d8b61bd
  • README.mdce5267e245d2
hivemind-tool.json 
{
  "id": "@dip497/log-tail",
  "name": "Log tail",
  "version": "1.0.1",
  "apiVersion": 1,
  "minAppVersion": "2026.10.3",
  "category": "monitoring",
  "description": "Follows a log file live: lines coloured by level, filtered by text or regular expression, and its errors handed to an agent.",
  "entry": "index.js",
  "permissions": [
    "workspace:spawn",
    "workspace:prompt"
  ],
  "commands": [
    {
      "name": "errors",
      "description": "The last 50 error lines of the log file the tile follows."
    },
    {
      "name": "tail",
      "description": "The last lines of the log file, each with its level (error, warn, info, debug or null).",
      "args": "{ \"lines\"?: number (1 to 5000, default 100), \"filter\"?: string (text, or /regex/) }"
    }
  ],
  "settings": [
    {
      "id": "file",
      "label": "Log file",
      "type": "text",
      "default": "app.log",
      "maxLength": 500,
      "description": "From the repository's top, or a full path. The tile's own field changes it for that tile."
    },
    {
      "id": "lines",
      "label": "Lines kept",
      "type": "number",
      "min": 50,
      "max": 5000,
      "default": 500,
      "description": "How many of the newest lines to show."
    }
  ],
  "tools": [
    {
      "key": "tail",
      "label": "Log tail",
      "description": "A log file, followed live.",
      "tileKind": "log-tail",
      "size": {
        "width": 1000,
        "height": 620
      },
      "needsRepo": false,
      "singleton": false,
      "glyph": "≡",
      "icon": "icon.svg"
    }
  ]
}

Hivemind shows you this list and asks before it installs.

  • Runs inside Hivemind, with the app's access to your files and network, once you switch it on
  • Start agents in your workspace
  • Tell an agent something (you send or cancel each one)
VersionCommitListed
1.0.1 fb488a4 October 28, 2026

Needs Hivemind 2026.10.3 or newer.

HiveHub keeps the version listed last. The ones before it are in the repository's history.

Something wrong with it? Report it.