TypeMill

---

Quick Start

``bash
npx @goobits/typemill start
`

That's it. No installation required.

---

What Can TypeMill Do?

$3

`
Before: After:
├── src/ ├── src/
│ ├── utils.ts ─────────────► │ ├── helpers.ts
│ ├── app.ts │ ├── app.ts
│ │ import { foo } from './utils'│ │ import { foo } from './helpers' ✓ Updated!
│ └── index.ts │ └── index.ts
│ import './utils' │ import './helpers' ✓ Updated!
`

$3

`
Before: After:
├── src/ ├── src/
│ ├── components/ │ ├── components/
│ │ └── Button.tsx │ │ └── ui/
│ └── App.tsx │ │ └── Button.tsx ◄── Moved!
│ import { Button } │ └── App.tsx
│ from './components/Button' │ import { Button }
│ │ from './components/ui/Button' ✓ Fixed!
`

$3

`
> inspect_code("src/server.ts", line=42, character=15)

{
"definition": "src/types.ts:18",
"type": "interface ServerConfig { port: number; host: string; }",
"references": [
"src/server.ts:42",
"src/server.ts:67",
"src/config.ts:12"
]
}
`

$3

`typescript
// Before: Messy inline code
const result = items
.filter(x => x.active)
.map(x => x.value * 2)
.reduce((a, b) => a + b, 0);

// After: refactor action="extract" kind="function" name="calculateActiveTotal"
function calculateActiveTotal(items: Item[]): number {
return items
.filter(x => x.active)
.map(x => x.value * 2)
.reduce((a, b) => a + b, 0);
}
const result = calculateActiveTotal(items);
`

---

Architecture

`
┌─────────────────────────────────────────────────────────────────┐
│ AI Assistant │
│ (Claude Code / Claude Desktop) │
└─────────────────────────────┬───────────────────────────────────┘
│ MCP Protocol (stdio/WebSocket)
▼
┌─────────────────────────────────────────────────────────────────┐
│ TypeMill │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────────────────┐ │
│ │ inspect_code│ │ rename_all │ │ workspace │ │
│ │ search_code │ │ relocate │ │ • find_replace │ │
│ │ │ │ prune │ │ • extract_dependencies │ │
│ │ │ │ refactor │ │ • verify │ │
│ └─────────────┘ └─────────────┘ └─────────────────────────┘ │
└─────────────────────────────┬───────────────────────────────────┘
│ Language Server Protocol
┌───────────────────┼───────────────────┐
▼ ▼ ▼
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ typescript- │ │ rust- │ │ pylsp │
│ language- │ │ analyzer │ │ │
│ server │ │ │ │ │
└─────────────┘ └─────────────┘ └─────────────┘
.ts .js .rs .py
`

---

Tools

| Tool | Description |
|------|-------------|
| inspect_code | Get definition, references, type info, diagnostics at a position |
| search_code | Search workspace symbols with fuzzy matching |
| rename_all | Rename symbols, files, or directories (updates all imports) |
| relocate | Move symbols, files, or directories |
| prune | Delete with cleanup (removes unused imports) |
| refactor | Extract functions, inline variables, reorder code |
| workspace | Find/replace, dependency extraction, project verification |

All refactoring tools support dry-run mode (default) for safe previews.

---

Installation

$3


`bash
npx @goobits/typemill start
`
Supported platforms for the npm package build: macOS (arm64) and Linux (arm64).

$3

`bash
npm install -g @goobits/typemill
typemill start
`

$3

`bash
git clone https://github.com/goobits/typemill
cd typemill
cargo build --release
./target/release/mill start
`

---

Configuration

Add to Claude Desktop (~/.config/claude/claude_desktop_config.json):

`json
{
"mcpServers": {
"typemill": {
"command": "npx",
"args": ["@goobits/typemill", "start"]
}
}
}
`

---

Supported Languages

| Language | LSP Server | Extensions |
|----------|------------|------------|
| TypeScript/JavaScript | typescript-language-server | .ts .tsx .js .jsx |
| Rust | rust-analyzer | .rs |
| Python | pylsp | .py` |

---

License

MIT