SynPost CLI 🚀

SynPost CLI is a lightweight Postman-like tool for the terminal built with Node.js, powered by blessed for UI and axios for HTTP requests.

Designed for developers who love working in the terminal (especially Linux users 👀), SynPost lets you send HTTP requests interactively without leaving your CLI.

✨ Features

• 🔵 Interactive Terminal UI (TUI)
• 🌐 Supports GET, POST, PUT, DELETE
• 🧾 Custom Headers (JSON format)
• 📦 Request Body (JSON format)
• ⏱ Response Time Measurement
• 🎨 Colored Status Output
• 🖱 Scrollable Response Viewer
• ⚡ Lightweight & Fast

📦 Installation

1️⃣ Install Dependencies

Make sure you have:

• Node.js v16+
• npm or yarn

Clone your project or place the script file:

git clone https://github.com/yourusername/synpost-cli.git
cd synpost-cli
npm install

Dependencies used:

• blessed
• axios

2️⃣ Make It Global Command (synpost)

Edit your package.json:

{
  "name": "synpost",
  "version": "1.0.5",
  "bin": {
    "synpost": "./index.js"
  }
}

Then run:

npm link

Now you can start it globally using:

synpost

🚀 Usage

Run:

synpost

You will see:

SynPost CLI v1.0.5

🎮 Controls

| Key | Action | |------|--------| | TAB | Switch input focus | | ENTER | Send request | | Arrow Left/Right | Move cursor | | Arrow Up/Down | Change method | | ESC / Ctrl + C | Exit | | Mouse Scroll | Scroll response |

🧪 Example Usage

🔹 Simple GET Request

1. Focus URL field
2. Enter:

https://jsonplaceholder.typicode.com/posts/1

3. Press ENTER

🔹 POST Request Example

Set method to POST.

Headers:

{
  "Content-Type": "application/json"
}

Body:

{
  "title": "hello",
  "body": "from synpost",
  "userId": 1
}

Press ENTER.

📤 Output Format

SynPost displays:

Status: 200 OK | Time: 123ms
--------------------------------------------
{
  "response": "data"
}

• ✅ Green = Success (2xx)
• ❌ Red = Error (4xx/5xx)

⚠️ Notes

• Headers and Body must be valid JSON.
• Body is ignored for GET requests.
• Timeout is set to 15 seconds.

🛠 Tech Stack

• Node.js
• blessed (Terminal UI)
• axios (HTTP client)

💡 Why SynPost?

If you:

• Prefer terminal over GUI
• Use Linux daily
• Love lightweight tools
• Do API testing while coding

SynPost is for you.

👨‍💻 Author

syntaxcommunity | Built with ❤️ for terminal lovers.

📄 License

MIT License

🔥 SynPost CLI — Postman power, terminal style.