self code adk

Agent which can read code of currently running application and help analyzing it. Its main purpose is to assist in debugging the whole application by enabling the agent, defined as a developer and multi-agent expert, to read the entire codebase.

usage

install the package

uv add self-code-adk

import it

from self_code_adk.agent import SelfCodeAgent

And add new sub agent

sub_agents=[gardener, weather],
+# include self_code_agent only for development purposes
+if dev_mode: 
+   self_code_agent=SelfCodeAgent("gemini-2.5-flash-preview-04-17")
+   sub_agents.append(self_code_agent)
root_agent = Agent(
    name="my-fancy-agen",
    model="gemini-2.5-flash-preview-04-17",
    description=("root agent which acts as coordinator"),
    instruction=(
        """
        blah   
        """
    ),
    sub_agents=sub_agent,
)

Security considerations

self-code-adk has access to app code and whole filesystem. It states a security risk and should never be run in production. It is designed purerly for local testing within trusted input.

Note: if instructed in malicious way, it can read any file. For example /etc/shadow. Even if LLM will reject request initialy, there is no secondary protection in place.

How it works

In short it is an agent with 2 tools:

1. find possible root directory with app code.
2. read the content of repository

Thats is all. LLM with instruction takes care of rest.

design

self-code is just an agent which can access the code. It can be plugged into an multiagent app and then app relevant questions will be delegated on demand.

sample chat

Here is screenshot of sample chat of multiagent app. App contains few agents, and one of them is returning capital cities for a country using a tool. Once asked, self-code agent reads and provides feedback on code quality.

idea definition

medium