OpenAI builds and deploys advanced AI models like GPT-4o for autonomous agents and workflows.
Shitty Coding Agent

About Shitty Coding Agent
Shitty Coding Agent is an open-source coding assistant designed to be installed via npm, enabling developers to write, read, and execute code directly through bash commands. It provides a streamlined, distraction-free environment tailored for quick prototyping and efficient session management. The tool emphasizes a low context footprint and customizable architecture, avoiding restrictive frameworks to suit individual workflows. While it excels at straightforward terminal-based tasks, it may struggle with complex or multi-step coding challenges. Developers can extend its functionality by adding custom hooks or loading on-demand skills, making it adaptable for various programming needs. It is particularly well-suited for backend developers, CLI tool builders, DevOps engineers, AI researchers, and software architects who prefer working in a terminal-centric workflow. The tool prioritizes simplicity and direct execution, making it ideal for rapid iteration and hands-on coding sessions without the overhead of a full IDE.
Key features
- Open-source and installable via npm
- Write, read, and run code using bash commands
- Low context footprint and customizable architecture
- No restrictive frameworks
- Extendable with custom hooks
- Load on-demand skills
- Manage coding sessions efficiently
- Prototyping-focused workflow
Use cases
- Write files and run bash commands via terminal
- Manage coding sessions and extend functionality with custom hooks
- Load on-demand skills for specific programming tasks
Pros
- Minimal and customizable agent harness with no restrictive built-in features
- Supports multiple modes including interactive, print/JSON, RPC, and SDK for flexible integration
- Extensible via TypeScript extensions, skills, prompt templates, and themes packaged as npm or git installable modules
- Tree-structured session history allowing branching, sharing, and context engineering
- Supports over 15 providers and hundreds of models with the ability to switch mid-session
Cons
- Lacks built-in sub-agents and plan mode, requiring custom implementation or third-party packages
- Primarily designed for terminal-centric workflows, which may limit usability for users preferring graphical interfaces
- Customization and extension development may require advanced technical knowledge
- No built-in sandboxing or SSH execution, relying on extensions for such functionality
Frequently asked questions about Shitty Coding Agent
What is Shitty Coding Agent and what does it do?
Shitty Coding Agent is a minimal agent harness designed for terminal-centric workflows, enabling developers to write, read, and execute code directly through bash commands. It allows users to customize the agent with extensions, skills, and prompt templates, and supports multiple modes such as interactive, print/JSON, RPC, and SDK.
Who is Shitty Coding Agent suitable for?
The tool is particularly well-suited for backend developers, CLI tool builders, DevOps engineers, AI researchers, and software architects who prefer working in a terminal environment. It is ideal for those who want a lightweight, customizable agent without the overhead of a full IDE.
How do I install Shitty Coding Agent?
Shitty Coding Agent can be installed via npm, pnpm, or bun using a single command. For example, run 'npm install -g --ignore-scripts @earendil-works/pi-coding-agent' or use the provided install scripts for curl, PowerShell, or other package managers.
Can I switch models mid-session with Shitty Coding Agent?
Yes, users can switch models mid-session using commands like '/model' or keyboard shortcuts such as Ctrl+L. The tool supports over 15 providers and hundreds of models, including Anthropic, OpenAI, Google, and more.
How does Shitty Coding Agent handle session history and branching?
Sessions are stored as tree structures, allowing users to navigate to any prior point, branch from there, and continue the session. Users can filter messages, label entries as bookmarks, export sessions to HTML, or share them via a GitHub gist.
Is Shitty Coding Agent extensible and customizable?
Yes, the tool is designed to be highly extensible. Users can add custom hooks, load on-demand skills, or install third-party extensions and packages to tailor the agent to their workflows. Features like sub-agents or plan mode can be built or installed as extensions.
Shitty Coding Agent Website Engagement
Last Update: 9 days ago