Skip to content

Claude Code style AI agent from scratch using Python

Notifications You must be signed in to change notification settings

awesome-software/ai-coding-agent

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

AI Agent

An AI agent that can execute tasks using tools and manage conversations.

Features

Core Functionality

  • Interactive and single-run modes
  • Streaming text responses
  • Multi-turn conversations with tool calling
  • Configurable model settings and temperature

Built-in Tools

  • File operations: read, write, edit files
  • Directory operations: list directories, search with glob patterns
  • Text search: grep for pattern matching
  • Shell execution: run shell commands
  • Web access: search and fetch web content
  • Memory: store and retrieve information
  • Todo: manage task lists

Context Management

  • Automatic context compression when approaching token limits
  • Tool output pruning to manage context size
  • Token usage tracking

Safety and Approval

  • Multiple approval policies: on-request, auto, never, yolo
  • Dangerous command detection and blocking
  • Path-based safety checks
  • User confirmation prompts for mutating operations

Session Management

  • Save and resume sessions
  • Create checkpoints
  • Persistent session storage

MCP Integration

  • Connect to Model Context Protocol servers
  • Use tools from MCP servers
  • Support for stdio and HTTP/SSE transports

Subagents

  • Specialized subagents for specific tasks
  • Built-in subagents: codebase investigator, code reviewer
  • Configurable subagent definitions with custom tools and limits

Loop Detection

  • Detects repeating actions
  • Prevents infinite loops in agent execution

Hooks System

  • Execute scripts before/after agent runs
  • Execute scripts before/after tool calls
  • Error handling hooks
  • Custom commands and scripts

Configuration

  • Configurable working directory
  • Tool allowlisting
  • Developer and user instructions
  • Shell environment policies
  • MCP server configuration

User Interface

  • Terminal UI with formatted output
  • Command interface: /help, /config, /tools, /mcp, /stats, /save, /resume, /checkpoint, /restore
  • Real-time tool call visualization

About

Claude Code style AI agent from scratch using Python

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 100.0%