hashgraph-online · internet-dot · May 31, 2026 · May 29, 2026 · May 29, 2026
diff --git a/.agents/plugins/marketplace.json b/.agents/plugins/marketplace.json
@@ -739,6 +739,21 @@
       "description": "macOS-only local camera plugin for explicit snapshots, streaming controls, and file-backed image input.",
       "icon": "./plugins/zfifteen/agent-vision/assets/composer-icon.png"
     },
+    {
+      "name": "agentgram",
+      "displayName": "Agentgram",
+      "source": {
+        "source": "local",
+        "path": "./plugins/jerryfane/agentgram"
+      },
+      "policy": {
+        "installation": "AVAILABLE",
+        "authentication": "ON_INSTALL"
+      },
+      "category": "Tools & Integrations",
+      "description": "Send explicit Telegram messages from Codex and local AI agents through a Telegram bot token and chat id.",
+      "icon": "./plugins/jerryfane/agentgram/assets/agentgram-logo.svg"
+    },
     {
       "name": "apple-calendar",
       "displayName": "Apple Productivity",

diff --git a/README.md b/README.md
@@ -186,6 +186,7 @@ Third-party plugins built by the community. [PRs welcome](#contributing)!
 
 - [Agent Message Queue](https://github.com/avivsinai/agent-message-queue) - File-based inter-agent messaging with co-op mode, cross-project federation, and orchestrator integrations.
 - [Agent Vision](https://github.com/zfifteen/agent-vision) - macOS-only local camera plugin for explicit snapshots, streaming controls, and file-backed image input.
+- [Agentgram](https://github.com/jerryfane/agentgram) - Send explicit Telegram messages from Codex and local AI agents through a Telegram bot token and chat id.
 - [Apple Productivity](https://github.com/matk0shub/apple-productivity-mcp) - Local Apple Calendar and Reminders tooling for macOS with Codex plugin adapters.
 - [AxonFlow](https://github.com/getaxonflow/axonflow-codex-plugin) - Runtime governance for Codex with policy enforcement on terminal commands, advisory checks for non-terminal tools via skills, PII/secret detection, and compliance-grade audit trails. Self-hosted via Docker.
 - [Bitbucket CLI](https://github.com/avivsinai/bitbucket-cli) - Manage Bitbucket repos, PRs, branches, issues, webhooks, and pipelines for Data Center and Cloud.

diff --git a/plugins.json b/plugins.json
@@ -2,8 +2,8 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "name": "awesome-codex-plugins",
   "version": "1.0.0",
-  "last_updated": "2026-05-27",
-  "total": 92,
+  "last_updated": "2026-05-29",
+  "total": 93,
   "categories": [
     "Development & Workflow",
     "Tools & Integrations"
@@ -509,6 +509,16 @@
       "source": "awesome-codex-plugins",
       "install_url": "https://raw.githubusercontent.com/zfifteen/agent-vision/HEAD/.codex-plugin/plugin.json"
     },
+    {
+      "name": "Agentgram",
+      "url": "https://github.com/jerryfane/agentgram",
+      "owner": "jerryfane",
+      "repo": "agentgram",
+      "description": "Send explicit Telegram messages from Codex and local AI agents through a Telegram bot token and chat id.",
+      "category": "Tools & Integrations",
+      "source": "awesome-codex-plugins",
+      "install_url": "https://raw.githubusercontent.com/jerryfane/agentgram/HEAD/.codex-plugin/plugin.json"
+    },
     {
       "name": "Apple Productivity",
       "url": "https://github.com/matk0shub/apple-productivity-mcp",

diff --git a/plugins/jerryfane/agentgram/.agents/plugins/marketplace.json b/plugins/jerryfane/agentgram/.agents/plugins/marketplace.json
@@ -0,0 +1,20 @@
+{
+  "name": "agentgram",
+  "interface": {
+    "displayName": "Agentgram"
+  },
+  "plugins": [
+    {
+      "name": "agentgram",
+      "source": {
+        "source": "local",
+        "path": "."
+      },
+      "policy": {
+        "installation": "AVAILABLE",
+        "authentication": "ON_INSTALL"
+      },
+      "category": "Productivity"
+    }
+  ]
+}
diff --git a/plugins/jerryfane/agentgram/.codex-plugin/plugin.json b/plugins/jerryfane/agentgram/.codex-plugin/plugin.json
@@ -0,0 +1,38 @@
+{
+  "name": "agentgram",
+  "version": "0.1.1",
+  "description": "Codex and AI-agent Telegram messaging plugin with a local CLI.",
+  "author": {
+    "name": "Jerry Fane",
+    "url": "https://github.com/jerryfane"
+  },
+  "repository": "https://github.com/jerryfane/agentgram",
+  "license": "MIT",
+  "keywords": [
+    "ai-agents",
+    "codex",
+    "codex-plugin",
+    "notifications",
+    "telegram",
+    "telegram-bot"
+  ],
+  "skills": "./skills/",
+  "interface": {
+    "displayName": "Agentgram",
+    "shortDescription": "Send Telegram messages from Codex and agent sessions.",
+    "longDescription": "Agentgram is a Codex Telegram plugin and local CLI for AI agents. It sends explicit, user-requested Telegram messages through the Telegram Bot API using a bot token and chat id from the user's environment.",
+    "developerName": "Jerry Fane",
+    "category": "Productivity",
+    "websiteURL": "https://github.com/jerryfane/agentgram",
+    "brandColor": "#1F8A70",
+    "composerIcon": "assets/agentgram-logo.svg",
+    "logo": "assets/agentgram-logo.svg",
+    "capabilities": [
+      "Read",
+      "Write"
+    ],
+    "defaultPrompt": [
+      "Use Agentgram to send a Telegram message."
+    ]
+  }
+}
diff --git a/plugins/jerryfane/agentgram/LICENSE b/plugins/jerryfane/agentgram/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jerry Fane
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/plugins/jerryfane/agentgram/README.md b/plugins/jerryfane/agentgram/README.md
@@ -0,0 +1,148 @@
+# Agentgram
+
+[![CI](https://github.com/jerryfane/agentgram/actions/workflows/ci.yml/badge.svg)](https://github.com/jerryfane/agentgram/actions/workflows/ci.yml)
+[![Release](https://img.shields.io/github/v/release/jerryfane/agentgram)](https://github.com/jerryfane/agentgram/releases)
+[![PyPI](https://img.shields.io/pypi/v/agentgram-tg)](https://pypi.org/project/agentgram-tg/)
+[![License](https://img.shields.io/github/license/jerryfane/agentgram)](LICENSE)
+
+Agentgram is a Codex Telegram plugin and agent-neutral messaging helper. It lets
+Codex and other local AI agents send explicit, user-requested Telegram messages
+through a Telegram bot token and chat id.
+
+Agentgram is intentionally local-first. It does not run a hosted service, and it
+does not send automatic completion notifications unless a future task explicitly
+adds that behavior.
+
+Use Agentgram when you want a Telegram notification plugin for AI agents, a
+simple way to send Telegram messages from Codex, or a reusable local CLI for
+agent messaging via a bot token.
+
+## Requirements
+
+- Python 3.12 or newer.
+- A Telegram bot token from BotFather.
+- A Telegram chat where the bot has been started or added.
+
+## Configuration
+
+Set secrets in your shell or agent runtime environment:
+
+```sh
+export TELEGRAM_BOT_TOKEN="123456:bot-token"
+export TELEGRAM_CHAT_ID="123456789"
+```
+
+Do not put real tokens in tracked files. `.env` and `.env.*` are ignored for
+local use, but environment variables are the preferred setup.
+
+For local setup templates, copy [.env.example](.env.example). It contains
+variable names only.
+
+## Usage
+
+Install the released CLI from PyPI:
+
+```sh
+pipx install agentgram-tg
+```
+
+Or install from a git checkout, then put the CLI on your `PATH`:
+
+```sh
+git clone https://github.com/jerryfane/agentgram.git ~/.agentgram/agentgram
+mkdir -p ~/.local/bin
+ln -sf ~/.agentgram/agentgram/bin/agentgram ~/.local/bin/agentgram
+```
+
+Run the local CLI:
+
+```sh
+agentgram doctor
+agentgram send "deploy finished"
+agentgram send --silent --no-preview "quiet update"
+agentgram send --parse-mode HTML "<b>deploy finished</b>"
+```
+
+To discover a chat id, first send a message to the bot in Telegram, then run:
+
+```sh
+agentgram chat-id
+```
+
+For raw Telegram `getUpdates` output:
+
+```sh
+agentgram chat-id --raw
+```
+
+To check whether the local git checkout is current using existing local refs, or
+to update with a fast-forward-only pull:
+
+```sh
+agentgram update --check
+agentgram update
+```
+
+`agentgram update` refuses dirty worktrees, validates the checkout after pulling,
+and prints runtime-specific next steps when it can detect them. Codex plugin
+users should reinstall or refresh the plugin and start a new thread so updated
+skills are loaded.
+
+## Codex Plugin
+
+The Codex plugin skill lives in `skills/agentgram/SKILL.md`, with the plugin
+manifest at `.codex-plugin/plugin.json`. The skill tells Codex to use the local
+`agentgram` CLI as the execution path. This repository also contains a public
+Codex marketplace file so Agentgram can be installed as a Codex Telegram plugin.
+
+To install Agentgram from the public Codex marketplace file in this repository:
+
+```sh
+codex plugin marketplace add jerryfane/agentgram --ref main
+codex plugin add agentgram@agentgram
+```
+
+Start a new Codex thread after installing so the Agentgram skill is loaded.
+Use `codex plugin marketplace upgrade agentgram` before reinstalling when you
+want newer Agentgram releases.
+
+When a user asks an agent to send a Telegram message, the agent should:
+
+1. Run `agentgram doctor`, or `bin/agentgram doctor` only from this repository
+   checkout.
+2. Run `agentgram send "message"`, or `bin/agentgram send "message"` only from
+   this repository checkout, if setup is valid.
+3. Avoid direct Telegram API calls unless the user explicitly asks to bypass the
+   Agentgram CLI.
+
+## Troubleshooting
+
+- Bot was not started: open Telegram, send any message to the bot, then run
+  `agentgram chat-id` again.
+- Bad token: run `agentgram doctor`; malformed tokens fail locally, and revoked
+  or wrong tokens fail the Telegram `getMe` check.
+- Missing chat id: set `TELEGRAM_CHAT_ID`, or pass `--chat-id <id>` for a
+  one-off send after the user provides the target chat.
+- Forbidden chat: add the bot to the target chat or start a private chat with
+  it, then retry after confirming the chat id.
+- Telegram API errors: Agentgram prints Telegram's error description without the
+  bot token. Re-run `agentgram doctor` before retrying.
+
+## Release Checks
+
+Before release, run:
+
+```sh
+python3 -m unittest discover -s tests -v
+python3 scripts/validate_manifest.py
+git diff --check
+```
+
+See [docs/release-checklist.md](docs/release-checklist.md) for the full
+checklist and fresh-clone smoke.
+
+## Status
+
+Released. Agentgram `v0.1.x` includes the Telegram CLI, Codex skill packaging,
+public Codex marketplace metadata, update ergonomics, release docs, and CI
+checks.
diff --git a/plugins/jerryfane/agentgram/assets/agentgram-logo.svg b/plugins/jerryfane/agentgram/assets/agentgram-logo.svg
diff --git a/plugins/jerryfane/agentgram/bin/agentgram b/plugins/jerryfane/agentgram/bin/agentgram
@@ -0,0 +1,17 @@
+#!/usr/bin/env python3
+"""Agentgram command entry point."""
+
+from pathlib import Path
+import sys
+
+
+ROOT = Path(__file__).resolve().parents[1]
+SRC = ROOT / "src"
+if str(SRC) not in sys.path:
+    sys.path.insert(0, str(SRC))
+
+from agentgram_tg.cli import main
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())
diff --git a/plugins/jerryfane/agentgram/pyproject.toml b/plugins/jerryfane/agentgram/pyproject.toml
@@ -0,0 +1,45 @@
+[build-system]
+requires = ["setuptools>=69", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "agentgram-tg"
+version = "0.1.1"
+description = "Telegram messaging CLI and Codex plugin for local AI agents."
+readme = "README.md"
+requires-python = ">=3.12"
+license = { text = "MIT" }
+authors = [
+  { name = "Jerry Fane" }
+]
+keywords = [
+  "agentgram",
+  "ai-agents",
+  "codex",
+  "codex-plugin",
+  "notifications",
+  "telegram",
+  "telegram-bot"
+]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Environment :: Console",
+  "Intended Audience :: Developers",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.12",
+  "Topic :: Communications :: Chat",
+  "Topic :: Software Development :: User Interfaces"
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://github.com/jerryfane/agentgram"
+Repository = "https://github.com/jerryfane/agentgram"
+Issues = "https://github.com/jerryfane/agentgram/issues"
+Changelog = "https://github.com/jerryfane/agentgram/releases"
+
+[project.scripts]
+agentgram = "agentgram_tg.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]