Skip to content

mmalmi/hashtree-git

v0.1.1MIT

Publish, clone, and collaborate on Git repositories through Hashtree using local keys and ordinary Git commands. No hosting account, email verification, or phone number is required.

GitHubOpen Website

Hashtree Git agent plugin

The plugin teaches an agent to use the existing command line tool. It contains one portable skill, no background hooks, and no hosted service or API key. Install the tool on the agent's execution host using the workflow guide. Installing the plugin alone does not install binaries or start a service.

Codex and ChatGPT desktop

codex plugin marketplace add mmalmi/hashtree
codex plugin add hashtree-git@hashtree-plugins

Restart the agent session and select Hashtree Git, or ask it to use the hashtree-git skill. For a local checkout, replace the repository argument with . while in this repository. The repository also exposes the plugin through .agents/plugins/marketplace.json in supported desktop clients.

OpenAI marks plugins that call local programs as Desktop only. A dot needs a supported local task on a connected computer for this plugin; installing it does not give a cloud-only dot access to your computer or networking privileges. Public-directory submission is separate from installing this repository.

Claude Code

claude plugin marketplace add mmalmi/hashtree
claude plugin install hashtree-git@hashtree-plugins

Start a new session, then invoke /hashtree-git:hashtree-git with your request. For local evaluation, run claude --plugin-dir ./plugins/hashtree-git from this checkout.

Grok Build and Grok Bot

Grok Build supports Claude-compatible plugins. From this checkout:

grok plugin install ./plugins/hashtree-git
grok inspect --json

Start a new session and use its plugin/skills menu to select the workflow. Grok Bot is a separate surface: give it the workflow guide and ask it to perform the task with its terminal, then save the verified procedure as a skill. This repository is not automatically listed in Grok Bot's Connect apps directory.

Hermes Agent

Hermes supports the root plugin.json Agent Plugins v1 package directly:

hermes plugins install mmalmi/hashtree/plugins/hashtree-git --no-enable
hermes plugins enable hashtree-git

Start a new session and ask Hermes to load hashtree-git:hashtree-git using skills_list and skill_view. No Hermes-specific Python extension or MCP server is needed. The terminal environment must have Git, the CLI and persistent storage for its identity. Plugin updates must not replace that identity.

Other Agent Skills clients

Install plugins/hashtree-git/skills/hashtree-git from the repository using your client's skill installer. Keep the whole folder together. The skill is the canonical workflow; platform manifests all refer to it.

What it accesses

When asked to run a Git workflow, the agent invokes Git and Hashtree commands, uses the selected local profile, and connects to its configured relays, storage servers, and peers. A push publishes the selected repository with its chosen visibility. The plugin does not inspect secret-key files; the CLI manages keys. An optional Hashtree daemon keeps serving until stopped. No telemetry is added.

Versions and updates

The plugin and Hashtree CLIs have separate versions. Plugin installation and updates do not upgrade htree or git-remote-htree. A fresh latest/unpinned setup uses that channel's current release; existing binaries change only through a separate upgrade. Preserve the identity and data directories when upgrading.

A compatible CLI release needs no plugin update while the documented commands, JSON fields, permissions, and setup still work. When instructions or package metadata change, bump both manifests' version together, validate, and publish a new ZIP or catalog revision. Catalog review and each client's update settings govern delivery; changing the repository does not update every installed copy.

Package and validate

From a committed checkout, create a small distribution ZIP without app sources, build artifacts, identities, or configuration:

git archive --format=zip --output=hashtree-git-plugin.zip HEAD:plugins/hashtree-git
claude plugin validate plugins/hashtree-git

Keep generated ZIPs outside commits. Validate an extracted ZIP too, and run the workflow with a fresh test identity before submitting to a directory. Public catalogs have separate review requirements; a valid package is not a listing.

Packaging references: OpenAI, desktop execution, Claude, Grok, and Hermes.