explaingit

irmia2026/irmia_devkit_open

14PythonAudience · developerComplexity · 3/5Setup · moderate

TLDR

A Python plugin for AstrBot that gives AI coding agents 61 development tools including safe file editing with auto-rollback, git and GitHub operations, file system search, linting, and security-hardened network requests. Configurable by tool group.

Mindmap

mindmap
  root((Irmia DevKit))
    Tool groups
      Safe file editing
      Git and GitHub
      File system search
      System info
    Key features
      Auto-rollback on failure
      Syntax checking
      Whitespace tolerance
    Security
      SSRF protection
      SQL injection guard
      Path traversal checks
    Integration
      AstrBot plugin
      GitHub CLI
      Ruff or ESLint
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Add 61 development tools to an AstrBot AI agent so it can safely edit files, run git commands, and browse the filesystem

USE CASE 2

Let an AI agent make code edits with automatic syntax checking and rollback when the edit breaks something

USE CASE 3

Enable GitHub PR and issue management from within an AI assistant conversation

USE CASE 4

Turn on only the tool groups you need via the config file to keep the agent focused

Tech stack

PythonAstrBotGitHub CLISQLite

Getting it running

Difficulty · moderate Time to first run · 30min

Requires an existing AstrBot installation, GitHub tools need the GitHub CLI, and file-name search on Windows requires the Everything utility.

License not specified in the README.

In plain English

Irmia DevKit is a plugin for AstrBot, a platform that runs AI assistant agents. The plugin gives those AI agents a set of 61 tools they can use when helping with software development tasks, covering everything from editing files and running git commands to searching the file system and checking code for errors. The README is primarily in Chinese, with an English version linked separately. The most distinctive tool in the set is called safe_edit, which handles code file changes through a five-step process: back up the original, attempt the replacement, check syntax, keep the change if syntax passes, and automatically roll back if it fails. It also handles the common situation where an AI agent specifies slightly wrong indentation in the text it wants to replace, by trying a whitespace-tolerant match before giving up. This reduces the back-and-forth needed when AI-generated edits are slightly off. The 61 tools are split into nine groups that can be turned on or off individually through a config file. The groups cover: safe file editing, git and GitHub operations (status, diff, commits, pull requests, issues, releases), file system browsing and search, system information (processes, ports, disk usage), network requests with protections against server-side request forgery attacks, text processing (HTML extraction, JSON queries, CSV parsing, log parsing), encoding and decoding, time utilities, and a handful of extras like UUID generation and SQLite querying. Some tools depend on external software. File name search on Windows requires a tool called Everything. GitHub operations require the GitHub CLI. Code linting picks from ruff, pylint, or eslint, whichever is installed, and falls back gracefully if none are found. Most of the 61 tools rely only on Python's standard library. The project is at version 2.3.0 and includes 100 automated tests covering security scenarios such as SSRF protection, zip path traversal, SQL injection, and regular expression denial-of-service.

Copy-paste prompts

Prompt 1
I'm setting up irmia_devkit_open as an AstrBot plugin. How do I configure the nine tool groups in the config file to only enable file editing and git operations?
Prompt 2
The safe_edit tool in irmia_devkit_open auto-rolls back if syntax fails. How does it handle whitespace-tolerant matching when an AI produces slightly wrong indentation?
Prompt 3
I want my AstrBot agent to manage GitHub PRs and issues using irmia_devkit_open. What external dependencies do I need to install first?
Prompt 4
How do I run the 100 automated tests in irmia_devkit_open to verify the SSRF protection and SQL injection guards are working correctly?
Open on GitHub → Explain another repo

← irmia2026 on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.