Package Exports

@ziggler/clanker
@ziggler/clanker/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@ziggler/clanker) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Clanker

npm version node version downloads

AI agents that actually do things

Not just suggestions—real actions, real changes, real time.

Demo

Refactoring an entire codebase with natural language

Quick Start

npm install -g @ziggler/clanker
clanker

That's it. Clanker will guide you through setup on first run.

What Can It Do?

# Refactor code intelligently
> "Replace all console.log with our logger utility"
✓ Found 47 instances across 12 files
✓ Applied context-aware replacements
✓ All tests still passing

# Understand and modify complex codebases  
> "Add error handling to all async functions"
✓ Analyzed 23 async functions
✓ Added try-catch with appropriate error handling
✓ Preserved existing logic flow

# Execute multi-step workflows
> "Set up a new React component with tests"
✓ Created Button.tsx with TypeScript props
✓ Added Button.test.tsx with coverage
✓ Updated component index exports

Key Features

🧠 Intelligent File Editing

Our order-invariant diff algorithm achieves 89% success rate vs 8% for traditional approaches. Learn more →

🛠️ Extensible Tool System

Every action is a tool. Create your own in minutes:

export default createTool({
  id: 'pr_ready',
  execute: async () => {
    await runTests();
    await checkLinting();
    await verifyTypes();
    return { ready: true };
  }
});

Tool docs →

🎨 Beautiful Terminal UI

React-powered terminal interface with:

Syntax highlighting
Real-time progress
Keyboard navigation
Confirmation dialogs

🔐 Safety First

Confirmation prompts for destructive actions
Dry-run mode for testing
Full operation history
Rollback capabilities

Philosophy

Traditional AI assistants are suggestion engines. Clanker is different—it's an action engine.

Instead of:

"Here's how you could refactor this code..."

Clanker says:

"I'll refactor this code. Here's what I'm changing... Approve?"

Read our full philosophy →

Documentation

🚀 Getting Started - Installation and first steps
🏗️ Architecture - How Clanker works under the hood
🔧 Tool Development - Create custom tools
📚 API Reference - Complete API documentation

Use Cases

🔄 Refactoring

Update imports across projects
Rename variables consistently
Modernize syntax patterns
Extract common functions

📝 Code Generation

Create components from specs
Generate test suites
Scaffold new features
Build API endpoints

🐛 Debugging

Add logging strategically
Trace execution paths
Identify error patterns
Fix type issues

📦 Project Management

Update dependencies safely
Configure build tools
Set up CI/CD pipelines
Manage git workflows

Contributing

We'd love your help making Clanker better!

Community

💬 Discussions - Ask questions, share ideas
🌟 Show & Tell - Share your tools and workflows
🐦 Twitter - Updates and tips

License

MIT © Ziggler

Stop copying suggestions. Start shipping changes.

⭐ Star on GitHub • 📚 Get Started • 🐦 Share