shar8 - task list for AI agents

io.github.triumphpcPublished by GitHub account triumphpcv1.0.0Updated Nov 4, 2026

Personal task list for AI agents: read, add and delegate tasks over MCP, reports return to the task.

VerifiedStreamable HTTPWeb executableAI & ML

Overview

shar8 - task list for AI agents's hosted MCP server (shar8.app); OAuth sign-in required; Streamable HTTP.

No AI overview yet: these facts come from the registry entry and the server itself.

Endpoint
shar8.app
Last checked

Installation

In SourceWeft

  1. Open shar8 - task list for AI agents in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.triumphpc%2Fshar8/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "shar8-task-list-for-ai-agents": {
      "type": "http",
      "url": "https://shar8.app/mcp"
    }
  }
}

README

shar8-agent

A Claude Code plugin that lets an agent work through your task list on a schedule.

You mark a task "Агенту" (For the agent) in shar8.app, a personal task manager with an MCP server. The plugin picks the task up over MCP, runs Claude Code locally on your machine, and writes the result back into the task notes. The task status becomes "На проверке" (needs review) or "Нужно уточнение" (needs your answer). Only you close the task. If no task is delegated, the model is not called at all.

  • Runs on your own Claude Code subscription or on your own ANTHROPIC_API_KEY. You choose the mode during install; there is no default.
  • The only channel to shar8 is MCP over HTTPS with your personal token. The plugin has no other network addresses.
  • By default the agent has no tools: it sees the task text and answers with text. Web search or other MCP servers are opt-in through ~/.config/shar8-agent/agent.json.
  • Sending anything outward (chat messages, mail) is off unless you describe an allow-list in send-policy.json.

Full documentation (Russian): plugin/README.md. Landing page: shar8.app/for-agents.

Install (Claude Code)

Requirements: Claude Code 2.1.308 or newer, Node.js 20 or newer, a personal shar8 token (cabinet, "Выдать токен"; shown once).

sh
claude plugin marketplace add triumphpc/shar8-agentclaude plugin install shar8-agent@shar8

Then, in a Claude Code session, run /shar8-agent:install and paste the printed line into a terminal. The slash command only prints the line, so the token never passes through the model. If the slash command is unavailable, run node "<installPath>/bin/shar8-agent.mjs" install, where <installPath> is the plugin path from claude plugin list --json.

The installer asks for the server address (Enter keeps the default https://shar8.app/mcp), the token (hidden input), the model mode and whether to set up a schedule (default: once a minute). At the end it makes a probe run of claude and says plainly if the probe failed.

Manage and update:

sh
node ~/.config/shar8-agent/shim.mjs statusnode ~/.config/shar8-agent/shim.mjs runnode ~/.config/shar8-agent/shim.mjs uninstall
claude plugin marketplace update shar8claude plugin update shar8-agent@shar8

Supported systems (honest status)

SystemStatus
macOSVerified live on 2026-11-02: real shar8.app, real Claude Code, scheduled by launchd on a subscription; a delegated task was picked up within a minute and returned a report.
LinuxImplemented (systemd user timer), checked with files and fakes. Not run live yet.
WindowsBeta. Implemented (Task Scheduler), not verified live.

Other MCP clients (OpenCode, Codex CLI) can connect to shar8 by token without this plugin; see the landing page above. This plugin itself targets Claude Code only.

Security notes

  • The agent sees all tasks you delegated to it, in full: title, notes, subtasks. Delegate only what you are fine sending to the model you chose.
  • The token is typed with hidden input and stored only in ~/.config/shar8-agent/env (mode 0600). It is not passed through command-line arguments, settings.json or ~/.claude.json, and not written to logs.
  • claude runs isolated: an empty tool list by default, --permission-mode dontAsk, MCP servers only from your agent.json, an allow-listed environment. Built-in tools in agent.json are limited to Read, Glob, Grep; Bash, Write, Edit and WebFetch are closed so the agent cannot read the token file.
  • Limits per run: up to 3 tasks per pass, 15 minutes and a 2.00 USD budget per task.
  • uninstall removes the schedule and keeps the token; uninstall --purge also removes the env file.

License

MIT, see LICENSE.

shar8-agent (по-русски)

Плагин Claude Code, который по расписанию разбирает ваши задачи в shar8.app.

Вы ставите в задаче пометку «Агенту». Плагин забирает её по MCP, запускает Claude Code локально на вашем компьютере и кладёт результат в заметки задачи. Статус станет «На проверке» или «Нужно уточнение», закрываете задачу только вы. Если делегированных задач нет, модель не вызывается.

Установка:

sh
claude plugin marketplace add triumphpc/shar8-agentclaude plugin install shar8-agent@shar8

Дальше в сессии Claude Code выполните /shar8-agent:install и вставьте напечатанную строку в терминал. Модель работает на вашей подписке Claude Code или на вашем ключе ANTHROPIC_API_KEY.

Статус систем: Mac проверен вживую 2 ноября 2026; Linux реализован, вживую не проверен; Windows в beta.

Безопасность: агент видит все делегированные ему задачи целиком. Токен хранится только в файле с правами 0600 и не попадает в аргументы команд и логи. По умолчанию у агента нет инструментов и он ничего не отправляет наружу. Подробности и полная документация: plugin/README.md.

Лицензия: MIT.

Source: README.md at commit 5a3b573

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

1
  1. v1.0.0LatestNov 4, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts