ecos 0.1.0
ecos CLI 0.1.0
The ecos CLI is the command-line tool for ecos, an open source FinOps data stack that transforms AWS Cost and Usage Reports (CUR) into clean, enriched, high-performance datasets. Its analytics-ready semantic layer enables cost transparency, allocation, and optimization with actionable insights.
Built For
- FinOps Teams — cost analysis & attribution, commitment optimization, custom KPIs
- Cloud Engineers — resource optimization, waste elimination, pinpoint cost drivers/trends
- Finance Teams — allocation & budgets, savings tracking, BI-ready reports
- Data Teams — custom models in the serve layer, curated breakdowns for BI
For complete ecos documentation, see the main README.
Installation
Homebrew (Recommended)
Install on macOS or Linux with Homebrew tap (prebuilt cask or formula):
brew tap ecos-labs/homebrew-ecos
brew install --cask ecos # Recommended for macOS (prebuilt binary)
# OR
brew install ecos # Formula mode (Linux/macOS)
Direct Binary Download
Download appropriate binary from assets:
macOS Intel:
curl -L -o ecos.tar.gz https://github.com/ecos-labs/ecos/releases/download/v0.1.0/ecos-darwin-amd64.tar.gz
tar -xzf ecos.tar.gz
sudo mv ecos /usr/local/bin/
chmod +x /usr/local/bin/ecos
macOS Apple Silicon:
curl -L -o ecos.tar.gz https://github.com/ecos-labs/ecos/releases/download/v0.1.0/ecos-darwin-arm64.tar.gz
tar -xzf ecos.tar.gz
sudo mv ecos /usr/local/bin/
chmod +x /usr/local/bin/ecos
Linux x86_64:
curl -L -o ecos.tar.gz https://github.com/ecos-labs/ecos/releases/download/v0.1.0/ecos-linux-amd64.tar.gz
tar -xzf ecos.tar.gz
sudo mv ecos /usr/local/bin/
chmod +x /usr/local/bin/ecos
Linux ARM64:
curl -L -o ecos.tar.gz https://github.com/ecos-labs/ecos/releases/download/v0.1.0/ecos-linux-arm64.tar.gz
tar -xzf ecos.tar.gz
sudo mv ecos /usr/local/bin/
chmod +x /usr/local/bin/ecos
Windows:
Download and extract the Windows zip file from the release assets. Add the directory to your PATH, or run ecos.exe directly.
Go Install
go install github.com/ecos-labs/ecos/code/cli@latest
Build from Source
git clone https://github.com/ecos-labs/ecos.git
cd ecos/code/cli
go build -o ecos main.go
sudo mv ecos /usr/local/bin/
Quick Start
ecos init
ecos transform run
ecos version
Prerequisites
- macOS, Linux, or Windows
- Python 3.8+ (for dbt features)
- Cloud CLI for AWS, Azure, or GCP as appropriate
More Info
- ecos Documentation - Complete ecos project documentation
- Full CLI docs
- Examples and troubleshooting
- Report issues
Changelog
Other work
- b0fbad9: Sync: chore(cicd): use dedicated token for CLI releases with access to homebrew-ecos repo (@C123R)
- 59fd1d5: refactor(init): update CUR input labels and fix imports (@C123R)
What's New in 0.1.0
See the changelog below for detailed changes in this release.
Support & Resources
- 📖 ecos Documentation - Main project README with complete documentation
- 📚 Complete Documentation
- 🐛 Report Issues
- 💬 Discussions
- 🏠 GitHub Repository
Contributors
C123R