- 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.78
Simply use:
cargo install atac
You can use pacman to install:
pacman -S atac
Simply use:
brew tap julien-cpsn/atac
brew install atac
Simply use:
dnf copr enable joxcat/atac
dnf install 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.76
Simply clone the repository and use:
cargo run
cargo run -- -h
Tip
Build the latest release
cargo build --release
Features | ATAC | Postman | Insomnia |
---|---|---|---|
Manage collections & requests | โ | โ | โ |
HTTP Client | โ | โ | โ |
Methods | โ | โ | โ |
- GET | โ | โ | โ |
- POST | โ | โ | โ |
- PUT | โ | โ | โ |
- PATCH | โ | โ | โ |
- 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) | โ | โ |
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 | โ ๐ | โ | โ |
-
To add
- Create a repo wiki
- Document the whole code
- Reserved env variables like {{AUTO_TIMESTAMP}} or {{AUTO_UUID}} (Julien-cpsn#81)
- Cancel pending request
- Command line usage (send requests, add new requests)
- Request body syntax highlighting
- Export a request to other code formats (raw, curl, PHP, JS, Rust, ...)
- OpenAPI & Insomnia import
-
To improve
- Editing cookies
- Auto-completion on env file variables
- 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
- Base URL property and authorization on collections
- VScode plugin to see and send requests
- Scoop installation
Note
Documentation will soon be published in the wiki section
You can read more about it here: https://github.com/Julien-cpsn/ATAC/releases/tag/v0.14.0
Thanks to @NachoNievaG you can have an ATAC floating window inside your nvim https://github.com/NachoNievaG/atac.nvim
- 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)
Library | Version | Reason |
---|---|---|
reqwest & reqwest cookie store | 0.12.5 & 0.8.0 | Send requests |
ratatui | 0.27.0 | Terminal UI framework |
crokey | 1.0 | Used to parse, use key bindings files and some utilities |
tui-big-text | 0.4.5 | Display big texts. Only used for displaying ATAC in the homepage. |
tui-tree-widget | 0.21.0 | Display tree-like lists. Used for displaying the collections. |
My fork of tui-textarea | 0.4.1 | Text area that handle a lot of features. Used for editing request body. |
throbber-widgets-tui | 0.6.0 | Display loading UI elements. Used when request is pending. |
ratatui-image | 1.0.1 | Display response images. |
image | 0.25.1 | Decode images. |
syntect | 5.2.0 | Syntax highlighting |
serde (serde_json, serde-yaml) | 1.0.203 (1.0.118, 0.9.34) | Serialize & Deserialize application data into files |
jsonxf | 0.1.1 | Pretty print JSON |
toml | 0.8.14 | Serialize & Deserialize application config files |
boa_engine | 0.18.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.3.1 | Parse cURL request files |
clap | 4.5.8 | Command Line Argument Parser |
dirs | 5.0.1 | Use system files |
arboard | 3.4.0 | Copy response body to clipboard |
tokio | 1.38.0 | Handle asynchronous requests |
parking_lot | 0.12.3 | Smaller, faster and more flexible implementation of RwLock and Mutex. Used everywhere. |
strum | 0.26.3 | 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.2.6 | Ordered hashmap. Used in environments to preserve files' values order |
base64 | 0.22.1 | Encode auth. |
regex | 1.10.5 | Regex. Using for parsing requests URL |
The binary file size goes from ~4.5 MB to ~7 MB depending on the platform. I try to keep it as small as possible.
- Cargo, Brew - @julien-cpsn
- Arch - @orhun
- Fedora copr - @joxcat
The MIT license for this project can be seen here