whatisgithub

What is medad?

behradkhodayar/medad — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · developerComplexity · 4/5Setup · moderate

In one sentence

medad is a terminal coding agent built on LangChain Deep Agents that reads, writes, and runs commands in your project with approval gated edits, sandboxes, and resumable sessions.

Mindmap

mindmap
  root((medad))
    What it does
      Terminal coding agent
      Approval gated edits
      Resumable sessions
    Tech stack
      Python
      LangChain
      LangGraph
      Docker
    Use cases
      Interactive coding assistant
      Headless scripting
      Sandboxed automation
    Audience
      Developers building with LLM agents

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

What do people build with it?

USE CASE 1

Run an approval gated AI coding assistant in the terminal that shows diffs before editing files.

USE CASE 2

Automate coding tasks headlessly in a sandboxed Docker or LangSmith environment for CI or scripting.

USE CASE 3

Define custom subagents and skills that the agent can delegate specific tasks to.

What is it built with?

PythonLangChainLangGraphDocker

How does it compare?

behradkhodayar/medad0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultymoderatemoderatemoderate
Complexity4/52/54/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires the uv Python tool and an API key for Anthropic or another supported model provider, project is marked work in progress.

No license information was found in the README.

So what is it?

medad is a terminal based coding agent, similar in spirit to Claude Code, built using LangChain's Deep Agents toolkit with LangGraph running underneath. It lets you chat with an AI in your terminal that can read, write, and edit files, run shell commands, and carry out multi-step coding tasks in your project directory. The agent works interactively, streaming its responses and showing a short summary of what tool it is using as it works. Before it changes a file or runs a shell command, it shows you exactly what it plans to do, a diff for file edits or the command line for shell actions, and waits for you to approve, reject, or mark it as always allowed. You can also set up an allowlist of commands that get approved automatically, though chained or piped commands never match the allowlist by prefix alone. Sessions are saved so you can resume a previous conversation later, and the agent can plan its own todo lists, delegate subtasks to named subagents you define, and load memory files that carry instructions and notes between sessions. It also supports a skills system, where you drop a folder containing a SKILL.md file into a skills directory and invoke it by name during a session. For safety, medad can run its file and shell tools inside a sandbox rather than directly on your machine, either a local Docker container or a remote LangSmith virtual machine, which is especially useful for its headless mode meant for scripting and automated pipelines. It can also connect to external tools through MCP servers, and supports tracing every turn and tool call through LangSmith if you set the right environment variables. To install and run it you use the uv Python package manager, set an API key for Anthropic or another supported provider, and start it from the command line. The README labels the project as a work in progress.

Copy-paste prompts

Prompt 1
Install medad with uv and run it in headless mode to add a hello.py file that prints hi.
Prompt 2
Configure a medad sandbox backend using Docker so file edits and shell commands run in an isolated container.
Prompt 3
Set up a custom subagent in medad's config.toml that reviews code changes for bugs and style issues.
Prompt 4
Explain how medad's approval gate works for shell commands and file edits.

Frequently asked questions

What is medad?

medad is a terminal coding agent built on LangChain Deep Agents that reads, writes, and runs commands in your project with approval gated edits, sandboxes, and resumable sessions.

What language is medad written in?

Mainly Python. The stack also includes Python, LangChain, LangGraph.

What license does medad use?

No license information was found in the README.

How hard is medad to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is medad for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.