# 🧙‍♂️ Sage: the senior dev in your terminal
## 🤔 Why Sage?
- Claude Code, Codex CLI, and Cursor are **hella expensive**.
- Most open-source “alternatives” are too complicated and cluttered doing too much for mid context engineering and agentic features they are have.
- I wanted a CLI that could switch between **any model I want** at any moment (500+ models, 50+ free ones).
## ⚙️ What It Does
- Reads your project, **understands your codebase**, and helps you **write, refactor, and debug** all without switching tabs or selling your kidney for a subscription.
- And yeah, it’s not just for coding. You can even ask it **how to get a girlfriend?** and sage will help (no agentic actions for that though, you gotta do that part yourself).
## ⬇️ How to Install
```
pip install sage-code
```
- and then type
```
sage
```
in the terminal of the directory you created for your project (not in your downloads or desktop folder ).
- then you will see
``` Welcome! Setting up and analyzing your project now...```
- After that, just follow the terminal instructions.
- Grab your API key from [OpenRouter](https://openrouter.ai/settings/keys), paste it in.
- select your favorite model, and start building your next project.
## 🧩 How It Works
- The fundamental protocol is inspired by the hardest-working gatekeepers we all know.
- If you’re into papers and minimal math, the technique’s on [arXiv](https://arxiv.org/abs/2510.14881)
- The code is minimalist by design.
- Inside the sage folder, you’ll find:
```text
sage/
├── Starters/ : sets up the project, initializes the protocol, and provides context
└── Core/ : handles the main agent orchestration and LLM communication
```
- Programming ideology? **Procedural spaghetti.**
- **Trust me bro** you can figure it out and customize it.
Just ask Sage itself (no ChatGPT though).
## 🤝 Oh btw,
- if you’re unemployed and got some time **to contribute** to this project:
- fork the repo,and make it cooler
- or just add up to my spaghetti.I’ll be around to merge your PRs.
## 📢 Final Words
- Just the first version, built after work — so don’t be harsh on babe.
- Made with ❤️ by a brokie named Fikre.
Raw data
{
"_id": null,
"home_page": null,
"name": "sage-code",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.12",
"maintainer_email": null,
"keywords": "cli, ai, assistant, developer-tools, claude code alternative, codex alternative, open source, productivity",
"author": null,
"author_email": "\"Fikresilase W. Abebayew\" <shitubilbila@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/fd/08/803f4cb56780921f504dc0123b15a736f6f8fb8d021b1923d0d73a8a170c/sage_code-0.1.3.tar.gz",
"platform": null,
"description": "# \ud83e\uddd9\u200d\u2642\ufe0f Sage: the senior dev in your terminal\r\n![Sage welcome page.](./sage/public/sage_start_page.jpg \"Sage welcome page snapshot.\")\r\n## \ud83e\udd14 Why Sage?\r\n\r\n- Claude Code, Codex CLI, and Cursor are **hella expensive**. \r\n- Most open-source \u201calternatives\u201d are too complicated and cluttered doing too much for mid context engineering and agentic features they are have. \r\n- I wanted a CLI that could switch between **any model I want** at any moment (500+ models, 50+ free ones).\r\n## \u2699\ufe0f What It Does\r\n\r\n- Reads your project, **understands your codebase**, and helps you **write, refactor, and debug** all without switching tabs or selling your kidney for a subscription. \r\n- And yeah, it\u2019s not just for coding. You can even ask it **how to get a girlfriend?** and sage will help (no agentic actions for that though, you gotta do that part yourself).\r\n## \u2b07\ufe0f How to Install\r\n\r\n ```\r\npip install sage-code\r\n```\r\n\r\n-\tand then type \r\n```\r\nsage\r\n```\r\n in the terminal of the directory you created for your project (not in your downloads or desktop folder ).\r\n- then you will see\r\n``` Welcome! Setting up and analyzing your project now...```\r\n- After that, just follow the terminal instructions.\r\n- Grab your API key from [OpenRouter](https://openrouter.ai/settings/keys), paste it in.\r\n- select your favorite model, and start building your next project.\r\n\r\n## \ud83e\udde9 How It Works\r\n- The fundamental protocol is inspired by the hardest-working gatekeepers we all know.\r\n- If you\u2019re into papers and minimal math, the technique\u2019s on [arXiv](https://arxiv.org/abs/2510.14881)\r\n- The code is minimalist by design.\r\n- Inside the sage folder, you\u2019ll find:\r\n```text\r\nsage/\r\n\u251c\u2500\u2500 Starters/ : sets up the project, initializes the protocol, and provides context \r\n\u2514\u2500\u2500 Core/ : handles the main agent orchestration and LLM communication \r\n```\r\n\r\n- Programming ideology? **Procedural spaghetti.**\r\n- **Trust me bro** you can figure it out and customize it.\r\nJust ask Sage itself (no ChatGPT though).\r\n## \ud83e\udd1d Oh btw,\r\n- if you\u2019re unemployed and got some time **to contribute** to this project: \r\n - fork the repo,and make it cooler\r\n - or just add up to my spaghetti.I\u2019ll be around to merge your PRs.\r\n## \ud83d\udce2 Final Words\r\n- Just the first version, built after work \u2014 so don\u2019t be harsh on babe. \r\n- Made with \u2764\ufe0f by a brokie named Fikre.\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A senior developer in your terminal.",
"version": "0.1.3",
"project_urls": {
"bugtracker": "https://github.com/Fikresilase/sage/issues",
"homepage": "https://github.com/Fikresilase/sage",
"repository": "https://github.com/Fikresilase/sage"
},
"split_keywords": [
"cli",
" ai",
" assistant",
" developer-tools",
" claude code alternative",
" codex alternative",
" open source",
" productivity"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "a1d9f4d76b391b8b8fd7b6156db15c8f9059e6a15713a960f9520cba55ffed39",
"md5": "317243ede898e5de8e45c5eb68f8573e",
"sha256": "8bf3e51b7879bc2cf2928d8a11d9399159596672f4d081516260c11fdd924ad6"
},
"downloads": -1,
"filename": "sage_code-0.1.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "317243ede898e5de8e45c5eb68f8573e",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.12",
"size": 36239,
"upload_time": "2025-10-21T09:29:03",
"upload_time_iso_8601": "2025-10-21T09:29:03.610849Z",
"url": "https://files.pythonhosted.org/packages/a1/d9/f4d76b391b8b8fd7b6156db15c8f9059e6a15713a960f9520cba55ffed39/sage_code-0.1.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "fd08803f4cb56780921f504dc0123b15a736f6f8fb8d021b1923d0d73a8a170c",
"md5": "562f528e5d706f809dbf73153db79e5b",
"sha256": "9d9396f993a49cbc1696a959dc85533b2ee2090ef600f752b7f2607f4ce15dc3"
},
"downloads": -1,
"filename": "sage_code-0.1.3.tar.gz",
"has_sig": false,
"md5_digest": "562f528e5d706f809dbf73153db79e5b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.12",
"size": 32555,
"upload_time": "2025-10-21T09:29:06",
"upload_time_iso_8601": "2025-10-21T09:29:06.118460Z",
"url": "https://files.pythonhosted.org/packages/fd/08/803f4cb56780921f504dc0123b15a736f6f8fb8d021b1923d0d73a8a170c/sage_code-0.1.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-21 09:29:06",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Fikresilase",
"github_project": "sage",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "sage-code"
}
JSON
