- Description
- How to install
- Features
- Documentation
- Others
- Technical precisions
- Contributors
- Star history
- License
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.
Important
First, make sure your rust version is at least 1.82
Simply use:
cargo install atac --locked
You can use pacman to install:
pacman -S atac
Simply use:
brew install atac
Simply use:
scoop install atac
Simply use:
dnf copr enable joxcat/atac
dnf install atac
Pull the image from https://hub.docker.com/r/juliencaposiena/atac
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 where atac is located).
Important
First, make sure your rust version is at least 1.82
Simply clone the repository and use:
cargo run
cargo run -- -hTip
Build the latest release
cargo build --release| Features | ATAC | Postman | Insomnia |
|---|---|---|---|
| Manage collections & requests | ✅ | ✅ | ✅ |
| HTTP Client | ✅ | ✅ | ✅ |
| Methods | ✅ | ✅ | ✅ |
| - GET | ✅ | ✅ | ✅ |
| - POST | ✅ | ✅ | ✅ |
| - PUT | ✅ | ✅ | ✅ |
| - | ✅ | ✅ | ✅ |
| - DELETE | ✅ | ✅ | ✅ |
| - HEAD | ✅ | ✅ | ✅ |
| - OPTIONS | ✅ | ✅ | ✅ |
| 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 | ✅ | ✅ | ❌ |
| WebSocket Client | ❌ 🔜 | ✅ | ✅ |
| GraphQL | ❌ 🔜 | ✅ | ✅ |
| gRPC | ❌ 🔜 | ✅ | ✅ |
| MQTT | ❌ 🔜 | ✅ | ❌ |
| Free | ✅ | Depends | Depends |
| Lightweight, fast and efficient | ✅ | ❌ | ❌ |
| Data storage | Your own committable, readable and versioned 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 | ✅ | ❌ | ❌ |
| Postman v2.1.0 import | ✅ | ✅ | ✅ |
| OpenAPI import | ✅ (AI generated, prone to bugs) | ✅ | ✅ |
| Themes | ✅ | ✅ | ✅ |
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) seanmonstar/reqwest#2259
To fix
- Query parameters bug
To add
- WebSocket requests
- Maybe GraphQL requests
- Maybe MQTT requests
- Maybe gRPC requests
To improve
- Auto-completion on env file variables
- Base URL property and authorization on collections
- VScode plugin to see and send requests
Here is the documentation: https://atac.julien-cpsn.com/
If you think something is missing, please contribute!
You can read more about it here: https://.com/Julien-cpsn/ATAC/releases/tag/v0.14.0
Thanks to @NachoNievaG you can have an ATAC floating window inside your nvim https://.com/NachoNievaG/atac.nvim
You can read more about it here: https://.com/Julien-cpsn/ATAC/releases/tag/v0.18.0
- 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)
| Category / Library | Version | Reason |
|---|---|---|
| Request | ||
| reqwest & reqwest cookie store | 0.12.12 & 0.8.0 | Send 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.0 | 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.0 | Display response images. |
| image | 0.25.6 | Decode images. |
| Main functionalities | ||
| syntect | 5.2.0 | Syntax highlighting |
| serde (serde_json, serde-yaml) | 1.0.217 (1.0.139, 0.9.34) | Serialize & Deserialize application data into files |
| jsonxf | 1.1.1 | Pretty print JSON |
| toml | 0.8.22 | Serialize & Deserialize application config files |
| boa_engine | 0.20.0 | Create Javascript runtimes. Used for pre and post request scripts |
| My fork of postman_collection | 0.2.3 | Deserialize Postman collection files |
| curl-parser | 0.5.0 | Parse cURL request files |
| openapiv3 | 2.1.0 | Parse OpenAPI spec files |
| clap | 4.5.38 | Command Line Argument Parser |
| directories | 6.0.0 | Use system files |
| arboard | 3.5.0 | Copy response body to clipboard |
| Async | ||
| tokio | 1.45.1 | Handle asynchronous requests |
| parking_lot | 0.12.3 | Smaller, faster and more flexible implementation of RwLock and Mutex. Used everywhere. |
| Utils | ||
| strum | 0.27.1 | 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.9.0 | Ordered hashmap. Used in environments to preserve files' values order |
| rayon | 1.10.0 | Allows the usage of multiple threads in for loops |
| thiserror | 2.0.11 | Create custom errors |
| anyhow | 1.0.98 | Result that can contain any error |
| clap-verbosity-flag | 3.0.3 | Add verbosity flag to the CLI |
| clap_complete | 4.5.50 | Generate completion file |
| clap_mangen | 0.2.26 | Generate man pages |
| regex | 1.11.1 | Regex. Using for parsing requests URL |
| chrono | 0.4.41 | Time utils |
| uuid | 1.17.0 | UUID generator |
| Tracing/Log | ||
| tracing | 0.1.41 | Log events |
| tracing-subscriber | 0.3.19 | Utilities for implementing and composing tracing subscribers |
| tracing-log | 0.2.0 | Log crate compatibility for tracing |
| reqwest-tracing | 0.5.7 | Opentracing middleware implementation for reqwest-middleware |
| reqwest-middleware | 0.4.2 | Wrapper around reqwest to allow for client middleware chains |
The binary file size goes from ~5 MB to ~12 MB depending on the platform. I try to keep it as small as possible, unfortunately for me, I bundle a Javascript runtime.
- Cargo, Brew, Docker - @julien-cpsn
- Arch - @orhun
- Fedora copr - @joxcat
The MIT license for this project can be seen here