A powerful Terminal User Interface (TUI) HTTP client
Combining Lazygit's elegant interface with Postman's API testing capabilities

Features • Installation • Quick Start • Shortcuts • Documentation • Contributing

LazyCurl is designed for developers who live in the terminal. It combines:

• Elegant Interface — Lazygit's proven multi-panel layout with vim motions
• Powerful Features — Postman's comprehensive HTTP testing capabilities
• File-Based Storage — Simple, versionable JSON/YAML files you can commit to git
• Keyboard-First — Full vim-style navigation, no mouse required

┌─Collections────────┬─Request──────────────────────────┐
│                    │ POST    {{base_url}}/api/users   │
│ ▼ My API           │──────────────────────────────────│
│   ▶ Users          │ Params │ Auth │ Headers │ Body   │
│     GET  /users    │──────────────────────────────────│
│     POST /users    │ {                                │
│     GET  /users/:id│   "name": "John Doe",            │
│   ▶ Products       │   "email": "{{user_email}}"      │
│                    │ }                                │
│                    ├─Response────────────────────────-┤
│                    │ 201 Created  │ 142ms │ 1.2 KB    │
│                    │──────────────────────────────────│
│                    │ {                                │
│                    │   "id": 123,                     │
│                    │   "name": "John Doe"             │
│                    │ }                                │
└────────────────────┴──────────────────────────────────┘
 NORMAL │ POST │ My API > Users > Create User │ dev │ ?:help

• URL with variable substitution ({{base_url}}/api/users)
• Headers with key-value editor
• Body Types: JSON, Form Data, Raw Text, Binary
• Query Parameters with interactive table
• Authorization: Bearer Token, API Key, Basic Auth

• Formatted Output: JSON syntax highlighting
• Status Badges: Color-coded (2xx green, 4xx orange, 5xx red)
• Metadata: Response time, size, headers
• Tabs: Body, Headers, Cookies, Console

• Request/Response Logging: View chronological history of all HTTP requests made during session
• Visual Status Indicators: Color-coded badges for 2xx/3xx/4xx/5xx responses and network errors
• Quick Actions: Resend requests, copy headers/body/error to clipboard
• Vim Navigation: Browse history with j/k, expand entries with Enter/l

• Automatic State Saving: Application state is saved automatically on changes
• Seamless Restore: Resume exactly where you left off when reopening
• What's Saved: Active panel, selected request, active environment, expanded folders, scroll positions, active tabs
• Smart Debouncing: 500ms delay prevents excessive writes during rapid changes
• Atomic Writes: Safe file operations using temp file + rename pattern
• Graceful Degradation: Missing or invalid session files are handled silently

{
  "name": "Development",
  "variables": {
    "base_url": { "value": "http://localhost:3000", "active": true },
    "api_token": { "value": "secret-token", "secret": true, "active": true }
  }
}

Built-in System Variables:

• {{$timestamp}} — Unix timestamp
• {{$datetime}} — RFC3339 datetime
• {{$uuid}} — UUID v4
• {{$randomInt}} — Random integer
• {{$random}} — Random alphanumeric string

• Go 1.21 or higher
• Terminal with Unicode support

# Clone the repository
git clone https://github.com/kbrdn1/LazyCurl.git
cd LazyCurl

# Build
make build

# Run
./bin/lazycurl

# Or install globally
make install

go install github.com/kbrdn1/LazyCurl/cmd/lazycurl@latest

# Live reload during development
make dev

cd your-api-project
lazycurl

LazyCurl automatically creates a .lazycurl/ directory:

.lazycurl/
├── config.yaml           # Workspace settings
├── collections/          # Your API collections
│   └── example.json
└── environments/         # Environment files
    └── development.json

1. Press n to create a new request
2. Enter request details (name, method, URL)
3. Press Enter to confirm
4. Press Ctrl+S to send the request

1. Press 2 or Tab to switch to Environments tab
2. Press n to create a variable
3. Use {{variable_name}} in your URLs and body

your-project/
├── .lazycurl/
│   ├── config.yaml              # Workspace configuration
│   ├── session.yml              # Session state (auto-generated)
│   ├── collections/
│   │   ├── api.json             # Collection file
│   │   └── admin.json
│   └── environments/
│       ├── development.json     # Environment file
│       ├── staging.json
│       └── production.json
└── ...

~/.config/lazycurl/
└── config.yaml                  # Global settings, themes, keybindings

{
  "name": "My API",
  "description": "API collection description",
  "folders": [
    {
      "name": "Users",
      "requests": [
        {
          "id": "req_001",
          "name": "Get All Users",
          "method": "GET",
          "url": "{{base_url}}/api/users",
          "headers": {
            "Authorization": "Bearer {{token}}"
          }
        },
        {
          "id": "req_002",
          "name": "Create User",
          "method": "POST",
          "url": "{{base_url}}/api/users",
          "headers": {
            "Content-Type": "application/json"
          },
          "body": {
            "name": "{{user_name}}",
            "email": "{{user_email}}"
          }
        }
      ]
    }
  ]
}

{
  "name": "Development",
  "description": "Local development environment",
  "variables": {
    "base_url": {
      "value": "http://localhost:3000",
      "active": true
    },
    "token": {
      "value": "dev-secret-token",
      "secret": true,
      "active": true
    },
    "user_name": {
      "value": "Test User",
      "active": true
    }
  }
}

LazyCurl uses the Catppuccin Mocha color scheme:

HTTP Method Colors:

• GET/HEAD: Green
• POST: Orange
• PUT: Blue
• PATCH: Purple
• DELETE: Red
• OPTIONS: Brown

Full documentation is available in the docs/ directory:

make build          # Build binary to bin/lazycurl
make run            # Build and run
make dev            # Live reload with air
make test           # Run tests
make test-coverage  # Generate coverage report
make fmt            # Format code
make lint           # Run linter
make clean          # Clean build artifacts
make build-all      # Cross-compile for all platforms

LazyCurl/
├── cmd/lazycurl/           # Application entry point
├── internal/
│   ├── api/                # HTTP client, collections, environments
│   ├── config/             # Configuration management
│   ├── format/             # Response formatting
│   └── ui/                 # User interface
│       ├── components/     # Reusable UI components
│       └── *.go            # Panel implementations
├── pkg/styles/             # Catppuccin theme and styles
├── docs/                   # Documentation
└── Makefile

Contributions are welcome! Please read our Contributing Guide for details.

# Fork and clone
git clone https://github.com/YOUR_USERNAME/LazyCurl.git
cd LazyCurl

# Create feature branch
git checkout -b feat/#123-your-feature

# Make changes and commit (using Gitmoji)
git commit -m "✨ feat(ui): add new feature"

# Push and create PR
git push origin feat/#123-your-feature

We use Gitmoji + Conventional Commits:

✨ feat(scope): add new feature
🐛 fix(scope): fix bug
📝 docs(scope): update documentation
♻️ refactor(scope): refactor code
🎨 style(scope): improve styling
✅ test(scope): add tests

• Lazygit-style multi-panel interface
• Vim-style navigation and modes
• Workspace system with file-based storage
• Configuration system (global + workspace)
• Collections and environments management

• Collection tree view with folders
• Environment management with variables
• Request builder UI
• Search functionality
• WhichKey keybinding hints
• HTTP request execution
• Response formatting
• CI/CD pipeline

• Responsive panel layout (horizontal on 80x24 terminals) #7
• Fullscreen panel toggle (F in NORMAL mode, h/l to navigate) #8
• Find in editors (/ in NORMAL mode) #24
• Settings Panel (Ctrl+; fullscreen with Global/Workspace tabs) #25
• Console tab in Response Panel (request/response history) #9
• Improved statusbar rendering and display #10
• Session persistence (.lazycurl/session.yml) #11
• Theme system refactoring #12
• Theme management and custom themes #13

• Import/export Postman collections #14
• Request history #15
• Pre-request & post-response scripting (JavaScript via Goja) #35
• Authentication helpers (OAuth2, AWS Sig) #17
• GraphQL support #18
• WebSocket testing #19
• gRPC support #20
• CLI commands architecture #26

This project is licensed under the MIT License - see the LICENSE file for details.

LazyCurl is built on the shoulders of giants:

• Lazygit — Inspiration for the TUI design
• Postman — Inspiration for API testing features
• Bubble Tea — TUI framework
• Lipgloss — Terminal styling
• Catppuccin — Color scheme

Made with ❤️ by @kbrdn1

⭐ Star us on GitHub