[PR #162] feat: add support for custom agents from config directory #48

New issue

Open

opened 2026-03-03 00:07:21 +03:00 by kerem · 0 comments

kerem commented

2026-03-03 00:07:21 +03:00

Owner

📋 Pull Request Information

Original PR: https://github.com/batrachianai/toad/pull/162
Author: @jingkaihe
Created: 1/3/2026
Status: 🔄 Open

Base: main ← Head: main

📝 Commits (4)

f27dd81 feat: add support for custom agents from config directory
9801e20 Merge remote-tracking branch 'upstream/main'
4d5716a Merge branch 'batrachianai:main' into main
c38d482 feat: add agent schema validation with error handling for custom agents

📊 Changes

4 files changed (+132 additions, -22 deletions)

View changed files

📝 src/toad/agent_schema.py (+41 -1)
📝 src/toad/agents.py (+79 -18)
📝 src/toad/cli.py (+2 -1)
📝 src/toad/screens/store.py (+10 -2)

📄 Description

Link to the discussion - https://github.com/batrachianai/toad/discussions/163

This PR added support for loading custom agents from <config_home>/agents/*.toml

e.g. I added

# Schema defined in agent_schema.py
# https://github.com/jingkaihe/kodelet

identity = "kodelet"
name = "Kodelet"
short_name = "kodelet"
url = "https://github.com/jingkaihe/kodelet"
protocol = "acp"
author_name = "Jingkai He"
author_url = "https://github.com/jingkaihe/kodelet"
publisher_name = "Jingkai He"
publisher_url = "https://github.com/jingkaihe/kodelet"
type = "coding"
description = "Kodelet is a lightweight agentic SWE Agent. It runs as an interactive CLI tool in your terminal. It is capable of peforming software engineering and production operating tasks."
tags = []
run_command."*" = "kodelet acp"

help = '''
...

into ~/.config/toad/agents/kodelet.toml, agents become available from the tui on toad launch:

This allows me to launch custom agent via toad serve which otherwise isn't available.

_{🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.}

## 📋 Pull Request Information **Original PR:** https://github.com/batrachianai/toad/pull/162 **Author:** [@jingkaihe](https://github.com/jingkaihe) **Created:** 1/3/2026 **Status:** 🔄 Open **Base:** `main` ← **Head:** `main` --- ### 📝 Commits (4) - [`f27dd81`](https://github.com/batrachianai/toad/commit/f27dd81aad147c1f0fcae69726b70d1f621a5bde) feat: add support for custom agents from config directory - [`9801e20`](https://github.com/batrachianai/toad/commit/9801e20c9effa92c78704b5d47cdd5b662c2e9d1) Merge remote-tracking branch 'upstream/main' - [`4d5716a`](https://github.com/batrachianai/toad/commit/4d5716a04da88f3ff8df9876e78d9ccb9ef3babb) Merge branch 'batrachianai:main' into main - [`c38d482`](https://github.com/batrachianai/toad/commit/c38d482ebc920963c3f3f6cc4563cf7d2bc71b69) feat: add agent schema validation with error handling for custom agents ### 📊 Changes **4 files changed** (+132 additions, -22 deletions) <details> <summary>View changed files</summary> 📝 `src/toad/agent_schema.py` (+41 -1) 📝 `src/toad/agents.py` (+79 -18) 📝 `src/toad/cli.py` (+2 -1) 📝 `src/toad/screens/store.py` (+10 -2) </details> ### 📄 Description **Link to the discussion** - https://github.com/batrachianai/toad/discussions/163 This PR added support for loading custom agents from `<config_home>/agents/*.toml` e.g. I added ```toml # Schema defined in agent_schema.py # https://github.com/jingkaihe/kodelet identity = "kodelet" name = "Kodelet" short_name = "kodelet" url = "https://github.com/jingkaihe/kodelet" protocol = "acp" author_name = "Jingkai He" author_url = "https://github.com/jingkaihe/kodelet" publisher_name = "Jingkai He" publisher_url = "https://github.com/jingkaihe/kodelet" type = "coding" description = "Kodelet is a lightweight agentic SWE Agent. It runs as an interactive CLI tool in your terminal. It is capable of peforming software engineering and production operating tasks." tags = [] run_command."*" = "kodelet acp" help = ''' ... ``` into `~/.config/toad/agents/kodelet.toml`, agents become available from the tui on `toad` launch: <img width="342" height="186" alt="image" src="https://github.com/user-attachments/assets/a147c47c-55dc-4e8c-82c3-2376af860ae9" /> This allows me to launch custom agent via `toad serve` which otherwise isn't available. --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>