@dawlabs/ncurl

A curl clone optimized for LLM cognitive patterns with intelligent HTTP inference

Installation

npm install @dawlabs/ncurl
# or
pnpm add @dawlabs/ncurl
# or
yarn add @dawlabs/ncurl

Usage

Command Line

# Display help
ncurl --help

# Display version
ncurl --version

# Run the main functionality
ncurl run

# Run with verbose output
ncurl run --verbose

# Run with custom config
ncurl run --config ./config.json

# Run with dry-run mode
ncurl run --dry-run

Programmatic Usage

import { main } from '@dawlabs/ncurl';

// Run the CLI programmatically
main(process.argv);

Commands

run [options]

Run the main functionality of the CLI tool.

Options:

• -v, --verbose: Enable verbose output
• -c, --config <path>: Specify a configuration file path
• -d, --dry-run: Show what would be done without executing
• -h, --help: Display help for the run command

Examples:

# Basic usage
ncurl run

# Verbose output
ncurl run --verbose

# Custom configuration
ncurl run --config ./my-config.json

# Dry run to preview actions
ncurl run --dry-run

API Reference

main(argv)

Main entry point for the CLI tool.

• argv: Array of command line arguments (typically process.argv)
• Returns: Promise<void>

Configuration

The CLI tool can be configured using a JSON file:

{
  "option": "value",
  "setting": true,
  "verbose": false
}

Development

# Install dependencies
pnpm install

# Build the CLI
pnpm build

# Run tests
pnpm test

# Lint code
pnpm lint

# Start development mode
pnpm dev

Environment

This CLI tool supports:

• Node.js 18+
• Windows, macOS, and Linux
• ES modules and CommonJS environments

License

MIT