22 releases (11 breaking)
| 0.22.1 | Oct 18, 2025 |
|---|---|
| 0.21.0 | Sep 11, 2025 |
| 0.20.2 | Jun 29, 2025 |
| 0.19.0 | Mar 23, 2025 |
| 0.16.0 | Jun 30, 2024 |
#122 in Web programming
23 downloads per month
685KB
13K
SLoC
ATAC ⚔📩
Table Of Contents
- Description
- How to install
- Features
- Documentation
- Others
- Technical precisions
- Contributors
- Star history
- License
Description
ATAC is Arguably a Terminal API Client. It is based on well-known clients such as Postman, Insomnia, or even Bruno, but inside your terminal without any specific graphical environment needed.
The philosophy of ATAC is to be free, account-less, and offline for now and forever.
How to install
Install with cargo
[!IMPORTANT] First, make sure your rust version is at least 1.82
Simply use:
cargo install atac --locked
Install from Arch
You can use pacman to install:
pacman -S atac
Install with Homebrew
Simply use:
brew install atac
Install with Scoop
Simply use:
scoop install atac
Install from Fedora copr
Simply use:
dnf copr enable joxcat/atac
dnf install atac
Docker package
Pull the image from https://hub.docker.com/r/juliencaposiena/atac
Binary
The binaries from the latest release can be found here
[!IMPORTANT] Remember to run it from a terminal. For example, you can add the binary into your PATH. You won't be able to run it like other graphical applications since it needs CLI arguments.
[!TIP] Note for macOS users. After downloading the binary you may need to run the command
sudo xattr -rd com.apple.quarantine ~/bin/atac(modify to reflect the path whereatacis located).
Compile by yourself
[!IMPORTANT] First, make sure your rust version is at least 1.82
Simply clone the repository and use:
cargo run
cargo run -- -h
[!TIP] Build the latest release
cargo build --release
Features
Current
| Features | ATAC | Postman | Insomnia |
|---|---|---|---|
| Manage collections & requests | ✅ | ✅ | ✅ |
| HTTP Client | ✅ | ✅ | ✅ |
| Methods | ✅ | ✅ | ✅ |
| - GET | ✅ | ✅ | ✅ |
| - POST | ✅ | ✅ | ✅ |
| - PUT | ✅ | ✅ | ✅ |
| - PATCH | ✅ | ✅ | ✅ |
| - DELETE | ✅ | ✅ | ✅ |
| - OPTIONS | ✅ | ✅ | ✅ |
| - HEAD | ✅ | ✅ | ✅ |
| - TRACE | ✅ | ❌ | ❌ |
| - CONNECT | ✅ | ❌ | ❌ |
| Authentication | Partial | ✅ | ✅ |
| - Basic auth | ✅ | ✅ | ✅ |
| - Bearer token | ✅ | ✅ | ✅ |
| - JWT, Digest, OAuth1-2, AWS | ❌ 🔜 | ✅ | ✅ |
| Headers | ✅ | ✅ | ✅ |
| Body | ✅ | ✅ | ✅ |
| - Multipart form | ✅ | ✅ | ✅ |
| - URL Encoded form | ✅ | ✅ | ✅ |
| - File | ✅ | ✅ | ✅ |
| - Plain text | ✅ | ✅ | ✅ |
| - JSON, XML, HTML, Javascript | ✅ | ✅ | ✅ |
| Full response | ✅ | ✅ | ✅ |
| - Status code | ✅ | ✅ | ✅ |
| - Cookies | ✅ | ✅ | ✅ |
| - Headers | ✅ | ✅ | ✅ |
| - Duration | ✅ | ✅ | ✅ |
| Scripting | ✅ | Partial | ❌ |
| - Pre-request script | ✅ | ❌ | ❌ |
| - Post-request script | ✅ | ✅ | ❌ |
| Asynchronous requests | ✅ | ✅ | ✅ |
| Per-request settings | ✅ | ✅ | ✅ |
| - Use proxy | ✅ | ✅ | ✅ |
| - Allow redirects | ✅ | ✅ | ✅ |
| - Store cookies | ✅ | ✅ | ✅ |
| Export to other languages (HTTP, cURL, PHP Guzzle, NodeJS Axios, Rust Reqwest) | ✅ | ✅ | ❌ |
| WebSocket Client | ✅ | ✅ | ✅ |
| Message | ✅ | ✅ | ✅ |
| - Text | ✅ | ✅ | ✅ |
| - Binary | ✅ | ❌ | ❌ |
| - Ping | ✅ | ❌ | ❌ |
| - Pong | ✅ | ❌ | ❌ |
| - Close | ✅ | ❌ | ❌ |
| GraphQL | ❌ 🔜 | ✅ | ✅ |
| gRPC | ❌ 🔜 | ✅ | ✅ |
| MQTT | ❌ 🔜 | ✅ | ❌ |
| Free | ✅ | Depends | Depends |
| Lightweight, fast and efficient | ✅ | ❌ | ❌ |
| Data storage | Your own committable, readable, versioned and retro-compatible files (JSON or YAML) | Tied to your account | Tied to your account |
| Offline | ✅ | ❌ | ❌ |
| Real-time collaboration | ❌ (not planned) | ✅ | ✅ |
| Full command line usage | ✅ | Partial | ❌ |
| Environment files and variables | ✅ (committable, readable and versioned) | ✅ | ✅ |
| View options | ✅ | ✅ | ✅ |
| Global configuration file | ✅ | ✅ | ✅ |
| - HTTP/HTTPS Proxy | ✅ | ✅ | ✅ |
| - Disable CORS | ✅ | ❌ | ❌ |
| - Toggle syntax highlighting | ✅ | ❌ | ❌ |
| Import from other file formats | ✅ | ✅ | ✅ |
| - Postman v2.1.0 and Postman environment import | ✅ | ✅ | ✅ / ❌ |
| - OpenAPI import | ✅ (AI generated, prone to bugs) | ✅ | ✅ |
| - cURL import | ✅ | ✅ | ✅ |
| Themes | ✅ | ✅ | ✅ |
| Remappable key bindings | ✅ | ✅ | ✅ |
TODO v1.0.0
-
To add
- Individual request documentation in the TUI (markdown)
- Insomnia import
-
To improve
- Editing cookies
- Request body syntax highlighting
- Manage multipart Content-type header (auto-generated for now) https://github.com/seanmonstar/reqwest/issues/2259
TODO v2.0.0
-
To add
- Maybe GraphQL requests
- Maybe MQTT requests
- Maybe gRPC requests
-
To improve
- Auto-completion on env file variables
Ideas (will think about it later)
- Base URL property and authorization on collections
- VScode plugin to see and send requests
Documentation
Here is the documentation: https://atac.julien-cpsn.com/
If you think something is missing, please contribute!
Others
Vim key-bindings
You can read more about it here: https://github.com/Julien-cpsn/ATAC/releases/tag/v0.14.0
NeoVim integration
Thanks to @NachoNievaG you can have an ATAC floating window inside your nvim https://github.com/NachoNievaG/atac.nvim
Themes
You can read more about it here: https://github.com/Julien-cpsn/ATAC/releases/tag/v0.18.0
Technical precisions
Tested on
- Console Host
- Windows 11 (Pro)
- WSL2 Debian 12
- Windows 10 (Pro)
- Windows 8.1 (N)
- Ubuntu Desktop Terminal
- Ubuntu 23.04 64-bit
- Ubuntu 17.10
- Pop!_OS 20.04
- (Arch, Manjaro) KDE Konsole
- (Arch, NixOS) Kitty
- Linux Mint
- (OpenSuse) Alacritty
- (Chrome OS) Crostini
- Apple
- macOS Monterey 12.7.1 (Intel-Chip)
- macOS Sonama 14.4 (M1 Max, Apple Silicon-Chip)
(List from here)
Dependencies
| Category / Library | Version | Comment |
|---|---|---|
| Request | ||
| reqwest | 0.12.23 | Send requests |
| reqwest-middleware | 0.4.2 | Wrapper around reqwest to allow for client middleware chains |
| reqwest-websocket | 0.5.1 | Wrapper around reqwest to handle web-socket requests |
| TUI | ||
| ratatui | 0.29.0 | Terminal UI framework |
| crokey | 1.1.2 | Used to parse, use key bindings files and some utilities |
| tui-big-text | 0.7.1 | Display big texts. Only used for displaying ATAC in the homepage. |
| tui-tree-widget | 0.23.1 | Display tree-like lists. Used for displaying the collections. |
| tui-textarea | 0.7.0 | Text area that handle a lot of features. Used for editing request body. |
| throbber-widgets-tui | 0.8.0 | Display loading UI elements. Used when request is pending. |
| ratatui-image | 8.0.1 | Display response images. |
| image | 0.25.8 | Decode images. |
| Main functionalities | ||
| syntect | 5.3.0 | Syntax highlighting |
| serde | 1.0.219 | Serialize & Deserialize application data into files |
| jsonxf | 1.1.1 | Pretty print JSON |
| toml | 0.9.5 | Serialize & Deserialize application config files |
| boa_engine | 0.20.0 | Create Javascript runtimes. Used for pre and post request scripts |
| parse_postman_collection | 0.2.3 | Deserialize Postman collection files |
| curl-parser | 0.6.0 | Parse cURL request files |
| openapiv3 | 2.2.0 | Parse OpenAPI spec files |
| clap | 4.5 | Command Line Argument Parser |
| directories | 6.0.0 | Use system files |
| arboard | 3.6.1 | Copy response body to clipboard |
| Async | ||
| tokio | 1.47.1 | Handle asynchronous requests |
| parking_lot | 0.12.4 | Smaller, faster and more flexible implementation of RwLock and Mutex. Used everywhere. |
| Utils | ||
| strum | 0.27.2 | Enum facilities |
| lazy_static | 1.5.0 | Allows for more flexible constants. Mainly used for accessing CLI arguments everywhere |
| nestify | 0.3.3 | Used to nest struct definitions |
| walkdir | 2.5.0 | Recursively retrieve files |
| snailquote | 0.3.1 | Unescape string |
| indexmap | 2.11.0 | Ordered hashmap. Used in environments to preserve files' values order |
| rayon | 1.11.0 | Allows the usage of multiple threads in for loops |
| thiserror | 2.0.16 | Create custom errors |
| anyhow | 1.0.99 | Result that can contain any error |
| clap-verbosity-flag | 3.0.4 | Add verbosity flag to the CLI |
| clap_complete | 4.5 | Generate completion file |
| clap_mangen | 0.2 | Generate man pages |
| regex | 1.11.2 | Regex. Using for parsing requests URL |
| chrono | 0.4.41 | Time utils |
| uuid | 1.18.0 | UUID generator |
| base64 | 0.22.1 | Decode base64 strings |
| textwrap | 0.16.2 | Wrap text to max length |
| Tracing | ||
| tracing | 0.1.41 | Log events |
| tracing-subscriber | 0.3.20 | Utilities for implementing and composing tracing subscribers |
| tracing-log | 0.2.0 | Log crate compatibility for tracing |
| reqwest-tracing | 0.5.8 | Opentracing middleware implementation for reqwest-middleware |
Binary size
The binary file size goes from ~5 MB to ~15 MB depending on the platform. I try to keep it as small as possible, unfortunately for me, I bundle a Javascript runtime.
Contributors
Maintainers
Packagers
- Cargo, Brew, Docker - @julien-cpsn
- Arch - @orhun
- Fedora copr - @joxcat
Star history
License
The MIT license for this project can be seen here
Dependencies
~69–115MB
~1.5M SLoC