# devtool

A unified developer toolbox — base64, JWT, timestamps, UUID, JSON format, hashing, URL, case conversion, colors, number bases, string ops, and regex — all from your terminal, SDK, API, or as MCP tools.

## CLI

```bash
npx devtool --help
```

### Examples

```bash
# Encode / decode
devtool base64 encode "hello world"
echo "aGVsbG8gd29ybGQ=" | devtool base64 decode

# JWT
devtool jwt decode eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiIxMjM0In0.Z2F1cmF2

# Timestamps
devtool ts now
devtool ts to-date 1768000000
devtool ts from-date "2026-07-11"

# UUID
devtool uuid v4
devtool uuid validate 550e8400-e29b-41d4-a716-446655440000

# JSON
echo '{"foo":"bar"}' | devtool json format
echo '{"foo":"bar"}' | devtool json minify
devtool json validate '{"valid": true}'

# Hash
echo -n "hello" | devtool hash sha256
devtool hash md5 "hello"

# URL
devtool url encode "hello world"
devtool url parse "https://example.com/path?q=1#hash"

# Case
devtool case camel "hello_world"
devtool case snake "helloWorld"
devtool case kebab "helloWorld"
devtool case pascal "hello-world"

# Color
devtool color hex-to-rgb "#ff6600"
devtool color rgb-to-hex 255 102 0

# Number bases
devtool number to-hex 255
devtool number to-bin 42
devtool number to-oct 64
devtool number from-hex FF

# String ops
devtool str len "hello"
devtool str reverse "hello"
devtool str upper "hello"
devtool str lower "HELLO"
devtool str trim "  hello  "
echo "hello world" | devtool str count "l"

# Regex
devtool regex test "^hello" "hello world"
devtool regex match "\\w+" "hello world 42"

# List tools
devtool list
```

All commands support `--json` for machine-readable output:
```bash
devtool uuid v4 --json
```

## SDK

```ts
import { DevToolSDK, base64Encode, uuidV4 } from '@talocode/devtool'

const devtool = new DevToolSDK()
console.log(devtool.base64.encode('hello'))
console.log(devtool.ts.now())
```

## API

```bash
# Start the API server
npx devtool-api

# Use it
curl -X POST http://localhost:3030/v1/base64/encode \
  -H 'Content-Type: application/json' \
  -d '{"input":"hello"}'

curl -X POST http://localhost:3030/v1/uuid/v4
curl http://localhost:3030/health
```

## MCP

Add to your MCP client config:

```json
{
  "mcpServers": {
    "devtool": {
      "command": "node",
      "args": ["path/to/dist/mcp/server.js"]
    }
  }
}
```

34 MCP tools available including base64 encode/decode, JWT decode, timestamps, UUID generation, JSON format/minify/validate, hashing, URL encode/decode/parse, case conversion, color conversion, number base conversion, string operations, and regex test/match.