![\"Uteke](\"https://raw.githubusercontent.com/codecoradev/uteke/develop/docs/assets/uteke-banner.png\")
\n\n \n
Give your AI a memory that never leaves your machine.
\n\n Your AI forgets everything between sessions. Uteke fixes that โ one binary, fully offline, ~45ms recall.\n
\n ![\"CI\"](\"https://github.com/codecoradev/uteke/actions/workflows/ci.yml/badge.svg?branch=develop\"){kind=icon}
\n ![\"Latest](\"https://img.shields.io/github/v/release/codecoradev/uteke?style=flat-square&color=green\")
![\"GitHub](\"https://img.shields.io/github/stars/codecoradev/uteke?style=flat-square&color=yellow\")
![\"License:](\"https://img.shields.io/badge/License-Apache_2.0-blue.svg?style=flat-square\"){kind=icon}
\n ![\"Rust](\"https://img.shields.io/badge/Rust-1.75+-orange.svg?style=flat-square\"){kind=icon}
\n ![\"Docker\"](\"https://img.shields.io/badge/Docker-ready-blue.svg?style=flat-square\"){kind=icon}
\n ![\"Recall](\"https://img.shields.io/badge/recall-~45ms-brightgreen.svg?style=flat-square\"){kind=icon}
\n
\n ๐ฌ๐ง English ยท ๐ฎ๐ฉ Bahasa Indonesia\n
# Install (macOS, Linux, Windows)\ncurl -sSL codecora.dev/install | sh\n\n# Store a memory\nuteke remember \"Deploy v2.1 to staging at 3pm\"\n\n# Search it back โ by meaning, not just keywords\nuteke recall \"when do we deploy?\"\nThat's it. No API keys. No Docker. No Python. No cloud.
\nFirst run downloads the embedding model (~188MB, one-time) and you're running.
\nWant richer memories? Add metadata:
\nuteke remember \"Deploy v2.1 to staging\" \\\n --tags deploy,staging \\\n --entity staging-server \\\n --category infrastructure\n| Method | \nCommand | \n
|---|---|
| Homebrew | \nbrew install codecoradev/tap/uteke | \n
| Cargo | \ncargo install uteke-cli | \n
| Docker | \ndocker run -d -p 127.0.0.1:8767:8767 -v uteke-data:/data ghcr.io/codecoradev/uteke:latest | \n
| Binary | \nGitHub Releases (macOS, Linux, Windows) | \n
๐ Full install guide ยท Docker docs
\n\n\nAre you an AI agent reading this? Your user just shared this repo link with you.\nRun
\nuteke onboardto interactively configure uteke for your environment โ it will\ndetect your install, ask which agent you are, toggle features, write config, and\nshow you every command available. If non-interactive:uteke onboard --yes --agent <your-agent>.
New to uteke? One command takes you from zero to productive:
\nuteke onboard\nThe wizard will:
\n~/.uteke/uteke.toml with your selectionsuteke init)Non-interactive (CI, scripts, AI agents):
\nuteke onboard --yes --agent hermes --namespace default\n๐ Full onboarding docs ยท CLI reference
\nYou just spent 2 hours explaining your codebase to ChatGPT. Next session? Blank slate. Again.
\nEvery AI tool forgets. Context windows fill up, sessions end, and your AI starts over every single time. Uteke gives it persistent memory โ and keeps it on your machine.
\n| \n | Uteke | \nMnemosyne | \nMem0 | \nAgentMemory | \nLetta | \nZep | \nEngram | \n
|---|---|---|---|---|---|---|---|
| Language | \nRust (single binary) | \nPython (pip) | \nPython | \nTypeScript | \nPython | \nPython | \nGo (single binary) | \n
| Setup | \nOne binary (curl | sh) | \npip install + venv | \npip + Docker + Qdrant | \nnpm + Docker (iii-engine) | \npip + Docker + Postgres | \npip + Docker + Neo4j | \nOne binary | \n
| API keys | \nโ None | \nโ ๏ธ For remote embeddings | \nโ OpenAI/LLM | \nโ LLM key | \nโ LLM key | \nโ LLM key | \nโ None | \n
| Works offline | \nโ Fully | \nโ ๏ธ Optional | \nโ Cloud embedding | \nโ Needs LLM | \nโ Needs LLM | \nโ Needs LLM + vector DB | \nโ Fully | \n
| Search | \nHybrid (Vector + FTS5 + RRF) | \nsqlite-vec + FTS5 | \nVector + Graph | \nVector + Graph | \nVector | \nTemporal Graph | \nFTS5 only | \n
| Recall speed | \n~45ms | \n~50ms+ | \nNetwork round-trip | \nNetwork round-trip | \nNetwork round-trip | \nNetwork round-trip | \n~Fast (local) | \n
| Multi-agent | \nโ Rooms (built-in collaboration) | \nโ ๏ธ Shared API | \nโ | \nโ | \nโ | \nโ | \nโ | \n
| Time-travel | \nโ Native point-in-time | \nโ ๏ธ Temporal triples | \nโ | \nโ | \nโ | \nโ | \nโ | \n
| MCP server | \nโ JSON-RPC + HTTP | \nโ stdio + SSE | \nโ | \nโ | \nโ | \nโ | \nโ | \n
| Your data | \nโ Never leaves machine | \nโ Local-first | \nโ ๏ธ Sent to LLM cloud | \nโ ๏ธ Sent to LLM cloud | \nโ ๏ธ Sent to LLM cloud | \nโ ๏ธ Sent to LLM cloud | \nโ Local | \n
| License | \nApache 2.0 | \nMIT | \nApache 2.0 | \nApache 2.0 | \nApache 2.0 | \nApache 2.0 | \nApache 2.0 | \n
\n\nUteke vs Mnemosyne: Both are local-first with semantic + FTS5 search. Mnemosyne is the closest competitor (~1.5K stars, Python). Uteke wins on single binary (no Python runtime), rooms, time-travel queries, and zero runtime dependencies.
\n
\n\nUteke vs Engram: Both are single-binary, offline, no-API-key tools. But Engram is FTS5-only (keyword search). Uteke adds vector semantic search + RRF fusion + rooms + time-travel + graph relationships + smart decay + document engine + batch import. Same simplicity thesis, 10ร the features.
\n
\n\nUteke vs AgentMemory/Mem0/Letta/Zep: Those are powerful โ but all require cloud LLM API keys and Docker infrastructure. Your data goes to OpenAI/Anthropic. Uteke runs fully offline with local ONNX embeddings. No Docker, no Python, no API keys.
\n
\n ![\"Uteke](\"https://raw.githubusercontent.com/codecoradev/uteke/develop/docs/assets/uteke-comparison.png\")
\n
๐ค Building AI agents? Give them persistent memory without cloud dependencies. Your agent remembers user preferences, past decisions, and context โ across sessions, fully offline.
\n๐ฅ Working in a team? Use Rooms to share knowledge. Meeting notes, project decisions, architecture choices โ searchable by everyone, attributed by author.
\n๐ Building for privacy-sensitive domains? Healthcare, finance, legal โ data stays on your machine. No API calls, no telemetry, no cloud. Local embeddings (ONNX, 768d).
\nโจ๏ธ Power user who lives in the terminal? Uteke is your personal knowledge graph. Remember anything, recall by meaning, link related thoughts. All from the command line.
\n| Feature | \nWhat it does | \n
|---|---|
| ๐ง Hybrid Search | \nVector similarity + FTS5 full-text search, merged by Reciprocal Rank Fusion (RRF). Finds by meaning AND exact keywords. | \n
| ๐ Rooms | \nGroup memories by context (meetings, projects, clients) with author attribution. | \n
| โณ Time-travel | \nRecall memories as they existed at any point in time. uteke recall \"deploy\" --at 2025-01-15 | \n
| ๐ท๏ธ Rich Metadata | \nTags, entities, categories, key:value pairs on every memory. | \n
| ๐งฉ Memory Types | \nTyped categories (fact, procedure, decision, etc.) with auto-inference. | \n
| โ๏ธ Partial Updates | \nUpdate content, tags, metadata, importance, or type without full rewrite. | \n
| ๐ Citations | \nSource attribution on every memory (URL, file, user, import batch). | \n
| Feature | \nWhat it does | \n
|---|---|
| ๐ Relationship Graph | \nLink memories with typed edges (supersedes, contradicts, references). Auto-backlinks. | \n
| ๐ Cross-Entity Linking | \nBidirectional memoryโdocument references via [[doc-slug]] wikilinks. | \n
| ๐ค Cosine Auto-Linking | \nAutomatically creates similar_to edges between related memories. | \n
| ๐ Smart Decay | \nComposite importance scoring. Pin what matters, let stale memories fade. | \n
| ๐ Salience + Recency | \nDual-axis recall boost by memory type and age. | \n
| ๐ Orphan Detection | \nFind disconnected, low-importance memories for cleanup. | \n
| ๐ Dream Cycle | \nOne-command maintenance: lint โ backlinks โ dedup โ orphans. | \n
| Feature | \nWhat it does | \n
|---|---|
| ๐ MCP Server | \nJSON-RPC over stdio + Streamable HTTP. Works with Claude Code, Cursor, Hermes. | \n
| ๐ฅ๏ธ Server Mode | \nPersistent daemon โ eliminates cold-start embedding load on every call. | \n
| ๐ Batch Import | \nImport entire directories with auto-strategy routing (document vs. memory extraction). | \n
| ๐ Document Engine | \nWiki/knowledge base with uteke doc create/get/list and auto-chunking. | \n
| ๐ฅ Import/Export | \nJSONL-based backup and restore. | \n
| ๐ View-Only API Keys | \nRead-only tokens for safe GET-only access to the server. | \n
| Feature | \nWhat it does | \n
|---|---|
| ๐ฆ Single Binary | \nZero dependencies. No Docker needed, no database server, no Python, no API keys. | \n
| ๐ Fully Offline | \nLocal ONNX embeddings (EmbeddingGemma Q4, 768d). No telemetry, no cloud. | \n
| โก Recall Cache | \nLRU cache eliminates redundant embedding for repeated queries. | \n
| ๐ฅ Tiered Memory | \nHot/Warm/Cold tracking with auto-cleanup of stale memories. | \n
| ๐ Embed Fallback | \nGracefully degrades to no-op embedder if local model fails (never crashes). | \n
| ๐ฅ Multi-Agent Namespaces | \nFully isolated memory per agent, zero overhead. | \n
| ๐ Benchmarks | \nBuilt-in uteke bench for perf testing. See results. | \n
// .mcp.json (Claude Code, Cursor)\n{ \"mcpServers\": { \"uteke\": { \"command\": \"uteke-mcp\" } } }\nFor Claude Desktop, Hermes, and HTTP transport, see MCP docs.
\n๐ Full documentation ยท CLI reference ยท Configuration
\ngraph LR\n Input[User Query] --> Embed[Local ONNX Embedder<br/>768d, EmbeddingGemma Q4]\n Embed --> HNSW[HNSW Vector Index<br/>usearch]\n Embed --> FTS5[FTS5 Full-Text<br/>SQLite]\n HNSW --> RRF[Reciprocal Rank Fusion<br/>k=60]\n FTS5 --> RRF\n RRF --> Results[Ranked Results]\n\n style Input fill:#4a9eff,color:#fff\n style Results fill:#4aff9e,color:#000\n style RRF fill:#ff9e4a,color:#fff\nHow hybrid search works:
\nEverything runs in-process. No network. No cloud. No server required (unless you want server mode).
\n\n ![\"Uteke](\"https://raw.githubusercontent.com/codecoradev/uteke/develop/docs/assets/uteke-architecture.png\")
\n
Mem0 and Letta are great โ but they require cloud API keys (OpenAI/LLM) and external infrastructure (Docker, Postgres, Qdrant). Your data gets sent to a cloud LLM provider. Uteke is a single binary with zero API keys. All embeddings run locally via ONNX. Your data never leaves your machine. See comparison table.
\n\nHow is Uteke different from AgentMemory?AgentMemory (25K stars) is a TypeScript/Node.js platform with 53 MCP tools and 12 auto-hooks. It's feature-rich but requires Docker + the iii-engine + LLM API keys. Uteke is Rust, zero dependencies, and works fully offline. If you want maximum integrations and don't mind cloud dependency โ AgentMemory. If you want privacy, speed, and zero setup โ Uteke.
\n\nHow is Uteke different from Engram?Engram (2.4K stars, Go) shares our philosophy: single binary, zero deps, MCP server, local-first. The key difference is search: Engram uses FTS5 only (keyword matching). Uteke uses hybrid search (HNSW vector similarity + FTS5 + Reciprocal Rank Fusion) โ meaning you can search by meaning, not just exact words. Uteke also adds rooms, time-travel, graph relationships, smart decay, document engine, and batch import.
\n\nWhat can Uteke remember?Anything text-based: decisions, meeting notes, code snippets, project context, personal notes, agent state. You can tag, categorize, and link memories. The --batch-dir flag lets you import entire document directories.
Yes. The embedding model (EmbeddingGemma Q4, 768d) downloads once (~188MB) on first run. After that, zero network calls. No telemetry. If the local model fails, Uteke degrades gracefully to a no-op embedder โ it never crashes and never calls a cloud API.
\n\nHow fast is recall?~45ms as a library (measured at 100โ10K memories). No network round-trip because everything is local. The LRU recall cache eliminates redundant embedding computation for repeated queries.
\n\nCan I use Uteke with my existing AI tools?Yes. Uteke ships with an MCP server that works with Claude Code, Cursor, and Hermes. You can also use the HTTP API directly in any language. See MCP setup โ
\n\nIs it production-ready?Uteke is at v0.7.3 with 206 tests, CI/CD on every commit, and benchmark harness. It's used in production by the CodeCora team and other early adopters. Still in 0.x โ expect rough edges, but the core is stable.
\ncargo build --workspace # Build\ncargo test --workspace # Test (206 tests)\ncargo clippy -- -D warnings # Lint\ncargo fmt # Format\nContributions welcome! Read CONTRIBUTING.md for the full guide.
\nApache License 2.0 โ use it, fork it, ship it.
\n\n Found this useful? โญ Star this repo โ it helps others discover Uteke.\n
\n\n \n ![\"Star](\"https://img.shields.io/github/stars/codecoradev/uteke?style=social\")
A free, offline-first, open source Point of Sale (POS) Progressive Web App built for Indonesian Micro, Small, and Medium Enterprises (UMKM). All data is stored locally on the user's device โ no server, no registration, no cost.
\n| Layer | \nTechnology | \n
|---|---|
| Framework | \nReact 18 + TypeScript | \n
| Build Tool | \nVite | \n
| Styling | \nTailwind CSS + shadcn/ui | \n
| Theming | \nnext-themes (dark mode) | \n
| Database | \nIndexedDB via Dexie.js | \n
| Charts | \nRecharts | \n
| Routing | \nReact Router DOM v6 | \n
| Forms & Validation | \nReact Hook Form + Zod | \n
| State | \n@tanstack/react-query | \n
| Icons | \nLucide React | \n
| i18n | \ni18next + react-i18next | \n
| Date | \ndate-fns (id, en-US, ms locales) | \n
| PWA | \nvite-plugin-pwa (Workbox) | \n
| Barcode | \nhtml5-qrcode (camera scanner + manual input) | \n
| Receipt | \nhtml2canvas (to PNG), Web Bluetooth Print (PWA), Bluetooth Classic (Android APK via Capacitor) | \n
| Font | \nPlus Jakarta Sans | \n
| Native Wrapper | \nCapacitor 8 (Android) | \n
# Clone the repository\ngit clone https://github.com/user/kasirgratisan.git\ncd kasirgratisan\n\n# Install dependencies\nnpm install\n\n# Start the development server\nnpm run dev\nThe app will be running at http://localhost:8080.
npm run build\nnpm run preview\nThis project can also run as a native Android app using Capacitor while keeping the PWA/web version working from the same codebase.
\nRequirements:
\nmacOS / Linux:
\nexport JAVA_HOME=\"/Applications/Android Studio.app/Contents/jbr/Contents/Home\"\nWindows (PowerShell):
\n$env:JAVA_HOME = \"C:\\Program Files\\Android\\Android Studio\\jbr\"\n\n\nAdjust the path if your Android Studio is installed elsewhere.
\n
npm run build\nnpx cap sync android\ncd android\n./gradlew assembleDebug\nOutput: android/app/build/outputs/apk/debug/app-debug.apk
npm run build\nnpx cap sync android\ncd android\n./gradlew bundleRelease\nOutput: android/app/build/outputs/bundle/release/app-release.aab
\n\nThe release AAB must be signed before uploading to Google Play. See Android signing docs.
\n
npm run cap:sync # build web bundle and sync Capacitor\nnpm run cap:android # build, sync, then open Android Studio\nnpm run cap:run # build, sync, then run on connected Android device/emulator\nsrc/\nโโโ App.tsx # Root component & routing\nโโโ main.tsx # Entry point\nโโโ index.css # Design tokens (HSL CSS variables)\nโโโ lib/\nโ โโโ db.ts # Dexie database schema, interfaces, seed data\nโ โโโ auth.ts # Multi-user auth helpers (PIN hashing, sessions, validation)\nโ โโโ utils.ts # Utility functions (cn, etc.)\nโ โโโ image-utils.ts # Image compression utility\nโ โโโ version-check.ts # Version check webhook\nโโโ components/\nโ โโโ layout/\nโ โ โโโ AppLayout.tsx # Main layout (responsive: max-w-lg mobile, max-w-6xl tablet/landscape)\nโ โ โโโ BottomNav.tsx # Bottom nav (5 tabs, center cashier CTA)\nโ โโโ Onboarding.tsx # First-run tutorial & store setup\nโ โโโ LoginScreen.tsx # Multi-user login (username + PIN)\nโ โโโ LockedPage.tsx # Permission-gated route fallback\nโ โโโ NavLink.tsx # Permission-aware nav link\nโ โโโ BackupReminder.tsx # Backup reminder & export utility\nโ โโโ Receipt.tsx # Receipt component (view, download, share, Bluetooth print)\nโ โโโ BarcodeScanner.tsx # Barcode/QR scanner with PWA-aware permission handling\nโ โโโ ThemeColorPicker.tsx # Accent color picker (8 presets)\nโ โโโ LanguageSwitcher.tsx # Language picker (ID, EN, MS)\nโ โโโ ui/ # shadcn/ui components (40+)\nโโโ i18n/\nโ โโโ index.ts # i18next initialization\nโ โโโ locales/\nโ โโโ id/ # Bahasa Indonesia\nโ โโโ en/ # English\nโ โโโ ms/ # Bahasa Malaysia\nโโโ pages/\nโ โโโ Dashboard.tsx # Home: stats, quick actions, low stock alerts\nโ โโโ Cashier.tsx # POS / cashier (barcode scan input, camera scanner, side-by-side cart on landscape)\nโ โโโ Products.tsx # Product CRUD (with description, SKU, units, photos)\nโ โโโ Reports.tsx # Sales reports & charts\nโ โโโ Settings.tsx # Settings (store, payments, categories, units, theme, backup, install PWA)\nโ โโโ Users.tsx # Multi-user management (owner only)\nโ โโโ Supplier.tsx # Supplier CRUD\nโ โโโ StockIn.tsx # Stock in + COGS calculation\nโ โโโ StockOut.tsx # Stock out\nโ โโโ StockReport.tsx # Stock movement reports\nโ โโโ TransactionHistory.tsx # Transaction history with open bill filter tabs\nโ โโโ NotFound.tsx # 404 page\nโโโ hooks/\n โโโ use-auth.tsx # Multi-user auth context (current user, permissions, login/logout)\n โโโ use-pwa-install.ts # PWA install prompt + standalone detection (incl. iOS)\n โโโ use-theme-color.ts # Accent color persistence\n โโโ use-mobile.tsx # Mobile breakpoint detection\n โโโ use-toast.ts # Toast helper\nAll data is stored locally in the browser using IndexedDB (via Dexie.js). No data is ever sent to any server.
\n| Table | \nDescription | \n
|---|---|
users | \nMulti-user accounts (owner/staff role, hashed PIN, granular permissions) | \n
categories | \nProduct categories (name, color, icon) | \n
products | \nMaster products (name, SKU, sell price, COGS, stock, unit, description) | \n
units | \nMaster units of measurement | \n
suppliers | \nSupplier data | \n
stockIns | \nStock-in records | \n
stockOuts | \nStock-out records | \n
hppHistory | \nCOGS change audit trail | \n
paymentMethods | \nPayment methods (Cash, Bank Transfer, QRIS, etc.) | \n
transactions | \nSales transactions (status: open/completed, customer name, table number, remarks) | \n
transactionItems | \nIndividual items within each transaction (per-item notes & discount) | \n
storeSettings | \nStore settings & app state (incl. multi-user toggle) | \n
When stock is received, COGS is automatically recalculated:
\nNew COGS = ((Old Stock ร Old COGS) + (New Qty ร Buy Price)) / (Old Stock + New Qty)\nGot suggestions, feature ideas, or found a bug? Submit and vote on our board:
\n\nJoin the Telegram group to discuss the app, ask questions, and share tips with other users:
\n๐ t.me/kasirgratisan
\nFreeKasir is proudly supported by:
\n\n![\"Sumopod\"](\"https://raw.githubusercontent.com/jipraks/kasirgratisan/main/public/sponsors/sumopod.png\")
\nWant to sponsor FreeKasir and have your logo featured here? Reach out at sponsorship@freekasir.com.
\nFreeKasir is built and maintained for free. If you find it useful, you can buy the developer a coffee to support continued development:
\n๐ traktir.jipraks.com
\nContributions are welcome! Here's how:
\ngit checkout -b feature/new-feature)git commit -m 'Add new feature')git push origin feature/new-feature)src/i18n/locales/{id,en,ms}/ JSON files inside the appropriate namespace (common, settings, products, reports, dashboard, onboarding)useTranslation('namespace') hook and t('key') in componentsi18n.language and NUMBER_LOCALES / CURRENCY_SYMBOL mapsdate-fns with locale from LOCALES mapshadcn/ui components from src/components/ui/toLocaleString('id-ID')useLiveQuery() from dexie-react-hooks for reactive data bindingcan() helper from useAuth() when multi-user is enabledBuilt with โค๏ธ for Indonesian small businesses.
\n\n
![\"python3.x\"](\"https://img.shields.io/badge/3.12.1-blue.svg?&logo=python&label=Python\"){kind=icon}
\n![\"Version](\"https://img.shields.io/pypi/v/pddiktipy?logo=Python&logoColor=white&label=PyPI&color=c125ff\")
![\"Downloads\"](\"https://img.shields.io/pepy/dt/pddiktipy?logo=PyPI&logoColor=white&label=Downloads&color=c125ff\")
![\"Author\"](\"https://img.shields.io/badge/Author-Ilham%20Riski-blue.svg?style=flat\"){kind=icon}
\n![\"License\"](\"https://img.shields.io/badge/License-MIT-green.svg\"){kind=icon}
\n\nLibrary Python untuk mengakses data PDDIKTI Kemdikbud dengan mudah, aman, dan terdokumentasi lengkap
\n
Wrapper API Python yang powerful dan user-friendly untuk mengambil data dari PDDIKTI Kemdikbud. Library ini menyediakan interface yang mudah digunakan untuk mengakses data mahasiswa, dosen, perguruan tinggi, dan program studi di Indonesia dengan dukungan type hints, error handling yang komprehensif, dan dokumentasi lengkap.
\npip install pddiktipy\nRequirements:
\nfrom pddiktipy import api\nfrom pprint import pprint\n\n# Menggunakan context manager (recommended)\nwith api() as client:\n # Cari semua data dengan keyword\n hasil = client.search_all('Unika Soegijapranata')\n pprint(hasil)\n \n # Cari mahasiswa spesifik\n mahasiswa = client.search_mahasiswa('Ilham Riski Wibowo')\n pprint(mahasiswa)\nLibrary ini menyediakan error handling yang komprehensif:
\nfrom pddiktipy import api\nfrom pddiktipy.exceptions import (\n ValidationError, \n APIConnectionError, \n APITimeoutError,\n PDDIKTIError\n)\n\ntry:\n with api() as client:\n # Ini akan raise ValidationError karena keyword kosong\n result = client.search_mahasiswa(\"\")\n \nexcept ValidationError as e:\n print(f\"Error validasi: {e}\")\nexcept APIConnectionError as e:\n print(f\"Error koneksi: {e}\")\nexcept APITimeoutError as e:\n print(f\"Request timeout: {e}\")\nexcept PDDIKTIError as e:\n print(f\"Error PDDIKTI API: {e}\")\nโก๏ธ API Documentation - 63 method API dengan dokumentasi komprehensif, contoh penggunaan, dan struktur data response
\nSemua response API menggunakan TypedDict untuk type safety dan konsistensi. Struktur data disesuaikan dengan konteks pendidikan Indonesia dan standar PDDIKTI.
\n๐ Changelog - Riwayat versi dan roadmap pengembangan
\n๐งช Testing Guide - Panduan testing dan quality assurance
\n๐ค Contributing Guide - Panduan berkontribusi pada proyek
\n๐ MIT License - Distributed under the MIT License
\nโญ Jika library ini membantu proyek Anda, jangan lupa untuk memberikan star di GitHub!
\n" }, - { - "fullName": "jipraks/kasirgratisan", - "name": "kasirgratisan", - "owner": "jipraks", - "ownerAvatarUrl": "https://avatars.githubusercontent.com/u/10278519?v=4", - "description": "Free, Open Source, Offline Point of Sales Apps", - "metaDescription": "Free, Open Source, Offline Point of Sales Apps", - "url": "https://github.com/jipraks/kasirgratisan", - "homepage": "", - "language": "TypeScript", - "stars": 111, - "forks": 57, - "topics": [], - "updatedAt": "2026-07-18T10:04:32Z", - "pushedAt": "2026-07-13T00:57:27Z", - "latestRelease": null, - "archived": false, - "licenseSpdx": "MIT", - "createdAt": "2026-02-12T11:02:43Z", - "openIssues": 0, - "openPullRequests": 1, - "subscribers": 1, - "communityHealth": 42, - "readmeHtml": "A free, offline-first, open source Point of Sale (POS) Progressive Web App built for Indonesian Micro, Small, and Medium Enterprises (UMKM). All data is stored locally on the user's device โ no server, no registration, no cost.
\n| Layer | \nTechnology | \n
|---|---|
| Framework | \nReact 18 + TypeScript | \n
| Build Tool | \nVite | \n
| Styling | \nTailwind CSS + shadcn/ui | \n
| Theming | \nnext-themes (dark mode) | \n
| Database | \nIndexedDB via Dexie.js | \n
| Charts | \nRecharts | \n
| Routing | \nReact Router DOM v6 | \n
| Forms & Validation | \nReact Hook Form + Zod | \n
| State | \n@tanstack/react-query | \n
| Icons | \nLucide React | \n
| i18n | \ni18next + react-i18next | \n
| Date | \ndate-fns (id, en-US, ms locales) | \n
| PWA | \nvite-plugin-pwa (Workbox) | \n
| Barcode | \nhtml5-qrcode (camera scanner + manual input) | \n
| Receipt | \nhtml2canvas (to PNG), Web Bluetooth Print (PWA), Bluetooth Classic (Android APK via Capacitor) | \n
| Font | \nPlus Jakarta Sans | \n
| Native Wrapper | \nCapacitor 8 (Android) | \n
# Clone the repository\ngit clone https://github.com/user/kasirgratisan.git\ncd kasirgratisan\n\n# Install dependencies\nnpm install\n\n# Start the development server\nnpm run dev\nThe app will be running at http://localhost:8080.
npm run build\nnpm run preview\nThis project can also run as a native Android app using Capacitor while keeping the PWA/web version working from the same codebase.
\nRequirements:
\nmacOS / Linux:
\nexport JAVA_HOME=\"/Applications/Android Studio.app/Contents/jbr/Contents/Home\"\nWindows (PowerShell):
\n$env:JAVA_HOME = \"C:\\Program Files\\Android\\Android Studio\\jbr\"\n\n\nAdjust the path if your Android Studio is installed elsewhere.
\n
npm run build\nnpx cap sync android\ncd android\n./gradlew assembleDebug\nOutput: android/app/build/outputs/apk/debug/app-debug.apk
npm run build\nnpx cap sync android\ncd android\n./gradlew bundleRelease\nOutput: android/app/build/outputs/bundle/release/app-release.aab
\n\nThe release AAB must be signed before uploading to Google Play. See Android signing docs.
\n
npm run cap:sync # build web bundle and sync Capacitor\nnpm run cap:android # build, sync, then open Android Studio\nnpm run cap:run # build, sync, then run on connected Android device/emulator\nsrc/\nโโโ App.tsx # Root component & routing\nโโโ main.tsx # Entry point\nโโโ index.css # Design tokens (HSL CSS variables)\nโโโ lib/\nโ โโโ db.ts # Dexie database schema, interfaces, seed data\nโ โโโ auth.ts # Multi-user auth helpers (PIN hashing, sessions, validation)\nโ โโโ utils.ts # Utility functions (cn, etc.)\nโ โโโ image-utils.ts # Image compression utility\nโ โโโ version-check.ts # Version check webhook\nโโโ components/\nโ โโโ layout/\nโ โ โโโ AppLayout.tsx # Main layout (responsive: max-w-lg mobile, max-w-6xl tablet/landscape)\nโ โ โโโ BottomNav.tsx # Bottom nav (5 tabs, center cashier CTA)\nโ โโโ Onboarding.tsx # First-run tutorial & store setup\nโ โโโ LoginScreen.tsx # Multi-user login (username + PIN)\nโ โโโ LockedPage.tsx # Permission-gated route fallback\nโ โโโ NavLink.tsx # Permission-aware nav link\nโ โโโ BackupReminder.tsx # Backup reminder & export utility\nโ โโโ Receipt.tsx # Receipt component (view, download, share, Bluetooth print)\nโ โโโ BarcodeScanner.tsx # Barcode/QR scanner with PWA-aware permission handling\nโ โโโ ThemeColorPicker.tsx # Accent color picker (8 presets)\nโ โโโ LanguageSwitcher.tsx # Language picker (ID, EN, MS)\nโ โโโ ui/ # shadcn/ui components (40+)\nโโโ i18n/\nโ โโโ index.ts # i18next initialization\nโ โโโ locales/\nโ โโโ id/ # Bahasa Indonesia\nโ โโโ en/ # English\nโ โโโ ms/ # Bahasa Malaysia\nโโโ pages/\nโ โโโ Dashboard.tsx # Home: stats, quick actions, low stock alerts\nโ โโโ Cashier.tsx # POS / cashier (barcode scan input, camera scanner, side-by-side cart on landscape)\nโ โโโ Products.tsx # Product CRUD (with description, SKU, units, photos)\nโ โโโ Reports.tsx # Sales reports & charts\nโ โโโ Settings.tsx # Settings (store, payments, categories, units, theme, backup, install PWA)\nโ โโโ Users.tsx # Multi-user management (owner only)\nโ โโโ Supplier.tsx # Supplier CRUD\nโ โโโ StockIn.tsx # Stock in + COGS calculation\nโ โโโ StockOut.tsx # Stock out\nโ โโโ StockReport.tsx # Stock movement reports\nโ โโโ TransactionHistory.tsx # Transaction history with open bill filter tabs\nโ โโโ NotFound.tsx # 404 page\nโโโ hooks/\n โโโ use-auth.tsx # Multi-user auth context (current user, permissions, login/logout)\n โโโ use-pwa-install.ts # PWA install prompt + standalone detection (incl. iOS)\n โโโ use-theme-color.ts # Accent color persistence\n โโโ use-mobile.tsx # Mobile breakpoint detection\n โโโ use-toast.ts # Toast helper\nAll data is stored locally in the browser using IndexedDB (via Dexie.js). No data is ever sent to any server.
\n| Table | \nDescription | \n
|---|---|
users | \nMulti-user accounts (owner/staff role, hashed PIN, granular permissions) | \n
categories | \nProduct categories (name, color, icon) | \n
products | \nMaster products (name, SKU, sell price, COGS, stock, unit, description) | \n
units | \nMaster units of measurement | \n
suppliers | \nSupplier data | \n
stockIns | \nStock-in records | \n
stockOuts | \nStock-out records | \n
hppHistory | \nCOGS change audit trail | \n
paymentMethods | \nPayment methods (Cash, Bank Transfer, QRIS, etc.) | \n
transactions | \nSales transactions (status: open/completed, customer name, table number, remarks) | \n
transactionItems | \nIndividual items within each transaction (per-item notes & discount) | \n
storeSettings | \nStore settings & app state (incl. multi-user toggle) | \n
When stock is received, COGS is automatically recalculated:
\nNew COGS = ((Old Stock ร Old COGS) + (New Qty ร Buy Price)) / (Old Stock + New Qty)\nGot suggestions, feature ideas, or found a bug? Submit and vote on our board:
\n\nJoin the Telegram group to discuss the app, ask questions, and share tips with other users:
\n๐ t.me/kasirgratisan
\nFreeKasir is proudly supported by:
\n\n\nWant to sponsor FreeKasir and have your logo featured here? Reach out at sponsorship@freekasir.com.
\nFreeKasir is built and maintained for free. If you find it useful, you can buy the developer a coffee to support continued development:
\n๐ traktir.jipraks.com
\nContributions are welcome! Here's how:
\ngit checkout -b feature/new-feature)git commit -m 'Add new feature')git push origin feature/new-feature)src/i18n/locales/{id,en,ms}/ JSON files inside the appropriate namespace (common, settings, products, reports, dashboard, onboarding)useTranslation('namespace') hook and t('key') in componentsi18n.language and NUMBER_LOCALES / CURRENCY_SYMBOL mapsdate-fns with locale from LOCALES mapshadcn/ui components from src/components/ui/toLocaleString('id-ID')useLiveQuery() from dexie-react-hooks for reactive data bindingcan() helper from useAuth() when multi-user is enabledBuilt with โค๏ธ for Indonesian small businesses.
\n![\"TEDI\"](\"https://raw.githubusercontent.com/IlhamriSKY/TEDI/main/public/icon.png\"){kind=icon}
\n One lightweight app. Eight features. Your whole dev workflow in a single window.
\n ![\"license\"](\"https://img.shields.io/badge/license-Apache--2.0-green\"){kind=icon}
![\"platform\"](\"https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows-lightgrey\"){kind=icon}
![\"no](\"https://img.shields.io/badge/runtime-no%20Electron-brightgreen\"){kind=icon}
![\"no](\"https://img.shields.io/badge/telemetry-none-blue\"){kind=icon}
TEDI (Terminal Environment & Development Infrastructure) folds eight tools you reach for every day (a terminal, SSH client, DB browser, editor, AI agent, browser, and Git) into one window, so you stop alt-tabbing. Built on Tauri 2, so a Rust core owns every OS resource and the UI is a single webview: no Node runtime, no bundled Chromium, and a resident footprint closer to a terminal than to an IDE. No telemetry; API keys stay in the OS keychain, and it runs fully offline against a local model if you want.
\n| # | \nFeature | \nWhat it does | \n
|---|---|---|
| 1 | \nTerminal multiplexer | \nNative PTY terminals (zsh / bash / fish / pwsh) on xterm.js + WebGL: split panes, tab groups, shell integration (OSC 7 / 133), inline search, and link detection. Inactive tabs keep streaming. | \n
| 2 | \nSSH connection | \nConnect to remote hosts (russh), open remote shells, and browse/transfer files over an integrated SFTP explorer, all from a saved connection manager. | \n
| 3 | \nSQL explorer (extension) | \nBrowse and query databases from a dedicated panel. Ships as an extension (feature 8), so it installs and updates at runtime. | \n
| 4 | \nCode editor | \nCodeMirror 6 for TS/JS, Rust, Python, PHP, HTML/CSS, JSON, Markdown, C/C++, Java, C#, SQL, and more, with inline AI autocomplete, diff view, Vim mode, and Markdown/image preview. | \n
| 5 | \nAI-native agent | \nBring-your-own-key agent across ten providers (OpenAI, Anthropic, Google, xAI, Cerebras, Groq, DeepSeek, SumoPod) and local models via LM Studio or any OpenAI-compatible server (Ollama, llama.cpp, vLLM). Plan mode, skills, MCP, ten sub-agents, voice input, project memory via TEDI.md, and tools gated by approval. | \n
| 6 | \nAI browser control | \nA real in-app browser (native webview) the agent drives end to end: navigate, read, type, click, scroll, screenshot the tab to see it, and read its console errors to find out why your page broke. | \n
| 7 | \nWorkspaces | \nEach workspace keeps its own project session (tab layout + working dirs) and switches instantly. The header folder picker spawns a terminal rooted there. | \n
| 8 | \nSource control + extensions | \nInline Git diff / SCM pane, and a first-class extension system: install from a .zip or GitHub release to add settings, AI tools, commands, keybindings, panels, and status / header / sidebar items. | \n
Everything is fully themeable (presets, custom colors, transparency) while staying lightweight.
\nPre-built binaries: Releases (Windows, macOS, Linux .deb / .rpm / .AppImage). Download for your OS and install; TEDI auto-checks for updates.
\n ![\"TEDI](\"https://raw.githubusercontent.com/IlhamriSKY/TEDI/main/docs/1.png\")
\n ![\"TEDI](\"https://raw.githubusercontent.com/IlhamriSKY/TEDI/main/docs/2.png\")
\n
\n ![\"TEDI](\"https://raw.githubusercontent.com/IlhamriSKY/TEDI/main/docs/3.png\")
\n ![\"TEDI](\"https://raw.githubusercontent.com/IlhamriSKY/TEDI/main/docs/4.png\")
\n
\n ![\"TEDI](\"https://raw.githubusercontent.com/IlhamriSKY/TEDI/main/docs/5.png\")
\n
Settings โ AI, pick a provider and paste your API key. Keys go to the OS keychain via keyring, never to disk or localStorage. Full list: PROVIDERS in src/modules/ai/config.ts.
Running fully local? Two routes, both keyless:
\nhttp://localhost:1234/v1).:11434), llama.cpp (:8080), vLLM (:8000), plus OpenRouter and 9Router. A localhost / 127.0.0.1 endpoint needs no API key; leave the field blank.The same providers back inline autocomplete (Settings โ AI โ Autocomplete), so ghost text works on a cloud key or entirely offline. Set the model id yourself when your server names models its own way (qwen2.5-coder:7b, a GGUF filename).
TEDI ships no extensions in the binary; every one (including the SQL explorer) installs at runtime. Re-installing the same manifest.id replaces the old copy, so the same path handles updates.
Settings โ Extensions โ From file (pick a local .zip)\nSettings โ Extensions โ From GitHub (paste owner/repo)\nSettings โ Extensions โ Check updates (re-check releases/latest)\nPer-extension icon, namespaced settings/secrets/storage, and a permission-gated host API. Authoring guide: extensions/README.md. Reference extension: Discord Rich Presence.
\ntedi [PATH] # open a folder or file in TEDI\ntedi . # open the current directory\ntedi ext <subcmd> # manage extensions headlessly (install / list / update / ...)\ntedi theme <subcmd> # manage themes from the terminal\ntedi --help | --version | --update\nIf TEDI is already running, the request forwards to the existing window (no second instance). On macOS / Linux AppImage the tedi command is not on PATH by default: Settings โ General โ \"Install tedi command in PATH\" creates a shim at ~/.local/bin/tedi. Windows' installer handles this.
A Tauri 2 app: a React 19 webview (src/) talks to a Rust backend (src-tauri/) via invoke() and streaming Channels. See ARCHITECTURE.md for a one-page map, then TEDI.md for the per-module reference.
Prereqs: Rust stable (rustup), Node 20.19+ / 22.12+ with pnpm, and Tauri's platform prereqs.
\npnpm install\npnpm tauri:dev # dev (isolated data dir)\npnpm tauri build # production bundle\nPre-PR checks (full list in CONTRIBUTING.md):
\npnpm exec tsc --noEmit && pnpm lint:imports && pnpm format:check\ncd src-tauri && cargo clippy && cargo fmt\npwsh.exe, powershell.exe, cmd.exe.EGL_BAD_PARAMETER or a blank window, set WEBKIT_DISABLE_DMABUF_RENDERER=1. AppImage needs FUSE (else --appimage-extract-and-run, or use the .deb / .rpm)./Applications, run xattr -cr /Applications/TEDI.app once, then open from Finder.TEDI is a fork of crynta/terax-ai@v0.5.9 by Crynta. The Tauri/Rust backend, the xterm.js terminal, the CodeMirror editor, and the AI agent pipeline are the work of Crynta and the Terax contributors. Same Apache-2.0 license; if TEDI is useful, please star upstream Terax.
\nApache-2.0. See LICENSE and NOTICE for required attribution.
\n" }, - { - "fullName": "giosakti/duragent", - "name": "duragent", - "owner": "giosakti", - "ownerAvatarUrl": "https://avatars.githubusercontent.com/u/524078?v=4", - "description": "Durable agent runtime. Sessions survive crashes. Agents are just files. One binary, zero dependencies.", - "metaDescription": "Durable agent runtime. Sessions survive crashes. Agents are just files. One binary, zero dependencies.", - "url": "https://github.com/giosakti/duragent", - "homepage": "http://docs.duragent.ai/", - "language": "Rust", - "stars": 48, - "forks": 2, - "topics": [], - "updatedAt": "2026-06-25T07:10:40Z", - "pushedAt": "2026-02-18T08:47:11Z", - "latestRelease": { - "name": "v0.5.4", - "tagName": "v0.5.4", - "url": "https://github.com/giosakti/duragent/releases/tag/v0.5.4", - "publishedAt": "2026-02-18T09:07:37Z" - }, - "archived": false, - "licenseSpdx": "MIT", - "createdAt": "2026-01-11T07:23:01Z", - "openIssues": 0, - "openPullRequests": 0, - "subscribers": 1, - "communityHealth": 100, - "readmeHtml": "![\"CI\"](\"https://github.com/giosakti/duragent/actions/workflows/ci.yml/badge.svg\"){kind=icon}
\n![\"Docs\"](\"https://img.shields.io/badge/docs-guide-blue\"){kind=icon}
![\"Rust\"](\"https://img.shields.io/badge/rust-1.91+-orange?logo=rust\"){kind=icon}
![\"License\"](\"https://img.shields.io/badge/license-MIT-blue.svg\"){kind=icon}
\n\nDuragent โ A durable, self-contained runtime for AI agents.
\n
Sessions survive crashes. Agents are just files. One binary, zero dependencies.
\nUse it as a personal AI assistant, or as the foundation for agent-powered products.
\n| What you get | \nHow | \n
|---|---|
| Sessions that survive crashes | \nAppend-only event log, attach/detach like tmux | \n
| Agents you can read and version | \nYAML + Markdown โ no code required | \n
| State you can inspect | \nJust files on disk โ cat, grep, git diff | \n
| Deploy anywhere | \nSingle binary, ~10MB, no Python/Node/Docker | \n
| Your choice of parts | \nSwap LLM providers, gateways, and storage backends or bring your own | \n
Download a prebuilt binary from GitHub Releases (Linux x86_64, macOS Intel/ARM), or build from source:
\ncargo install --git https://github.com/giosakti/duragent.git\n\nduragent init\n# Follow the interactive setup\nexport OPENROUTER_API_KEY=your-key # or: duragent login anthropic\nduragent chat --agent <YOUR_AGENT_NAME>\nduragent attach --list # List attachable sessions\nduragent attach SESSION_ID # Reconnect to existing session\nduragent doctor for diagnostics, duragent upgrade for self-updateUse the built-ins, or swap in your own:
\n| Component | \nDefault | \nSwappable | \n
|---|---|---|
| Gateways | \nCLI, HTTP, SSE, Telegram, Discord | \nAny platform via gateway plugins | \n
| LLM | \nOpenRouter | \nAnthropic, OpenAI, Ollama, or any provider | \n
| Sandbox | \nTrust mode | \nbubblewrap, Docker (planned) | \n
| Storage | \nFilesystem | \nPostgres, S3 (planned) | \n
./.duragent/\nโโโ agents/<agent-name>/\nโ โโโ agent.yaml # Agent definition (Duragent Format)\nโ โโโ SOUL.md # \"Who the agent IS\" (identity and personality)\nโ โโโ SYSTEM_PROMPT.md # \"What the agent DOES\" (core system prompt)\nโ โโโ INSTRUCTIONS.md # Additional runtime instructions (optional)\nโ โโโ policy.yaml # Tool execution policy (optional)\nโ โโโ skills/ # Modular capabilities (SKILL.md files)\nโ โโโ tools/ # Agent-specific auto-discovered tools\nโ โโโ memory/\nโ โโโ MEMORY.md # Curated long-term memory\nโ โโโ daily/ # Daily experience logs\nโโโ sessions/\nโ โโโ <session_id>/\nโ โโโ events.jsonl # Append-only event log\nโ โโโ state.json # Snapshot for fast resume\nโโโ tools/ # Workspace-level auto-discovered tools\nโโโ schedules/ # Scheduled tasks and run logs\nโโโ processes/ # Background process metadata and logs\nโโโ memory/\n โโโ world/ # Shared knowledge across all agents\nRead the Duragent Guide for installation, configuration, and usage.
\nFor contributors: CONTRIBUTING.md | Project Status | Internal Specs
\n![\"npm](\"https://img.shields.io/npm/v/bansosdev?label=bansosdev&color=10b981\")
![\"License:](\"https://img.shields.io/badge/License-MIT-10b981.svg\"){kind=icon}
\n![\"Built](\"https://img.shields.io/badge/Built%20with-SvelteKit-ff3e00\"){kind=icon}
![\"Deploy:](\"https://img.shields.io/badge/Deploy-Cloudflare%20Pages-F38020?logo=cloudflare&logoColor=white\"){kind=icon}
![\"Discord\"](\"https://img.shields.io/badge/Discord-Join%20Server-5865F2?logo=discord&logoColor=white\"){kind=icon}
![\"Telegram\"](\"https://img.shields.io/badge/Telegram-Join%20Channel-0088cc?logo=telegram&logoColor=white\"){kind=icon}
![\"Bansos](\"https://raw.githubusercontent.com/wauputr4/bansos/main/static/og-banner.png\")
๐ฎ๐ฉ Indonesia (Default) ยท ๐ English
\nBantuan sosial untuk developer jelata
bansos.dev adalah open-source katalog info bagi-bagi berkah, promo gratisan, dan diskonan tools coding paling legit khusus untuk developer jelata di Indonesia. Dibuat biar portofolio kita-kita tetep menyala walau dompet lagi sekarat. Nyari domain gratis, hosting free-tier, cloud credits, API credits, database gratisan, atau startup credits? Di sini tempat ngumpulnya! 100% Gratisan, No Clickbait, No Ribet. fr fr ๐
\nSitus ini dibangun sebagai static SvelteKit site yang super SEO-friendly, data-driven, aman di mode terang/gelap, dan gampang banget buat dikontribusikan lewat email atau merge request.
\nbansos developer, promo developer Indonesia, domain gratis, cloud credits gratis, API credits, hosting free tier, startup credits, developer tools gratis, open source Indonesia, SvelteKit static site.
![\"WhatsApp\"](\"https://img.shields.io/badge/WhatsApp-Follow%20Channel-25D366?logo=whatsapp&logoColor=white\"){kind=icon}
src/lib/data/bansos.json.Situs ini di-deploy dan di-hosting menggunakan Cloudflare Pages dengan adapter @sveltejs/adapter-cloudflare. Setiap kali ada merge request atau push ke branch main, Cloudflare secara otomatis memicu build dan mendistribusikan situs statis super cepat beserta seluruh dynamic OG image yang sudah di-prerender.
npm install\nnpm run dev\nnpm run build\nValidasi lokal:
\nnpm run check\nnpm run lint\nsrc/lib/data/bansos.json # data utama listing bansos\nsrc/lib/data/bansos.ts # helper selector, sorting, dan contributor stats\nsrc/lib/components/ # komponen UI reusable\nsrc/routes/list/ # halaman list dan detail bansos\nsrc/routes/contribute/ # panduan kontribusi publik\nscripts/add-bansos.mjs # script lokal tambah data\npackages/bansosdev-cli/ # CLI bansosdev (disabled untuk submit publik)\nUntuk saat ini, submit publik yang aktif adalah via email dan Git clone. Jalur form, npx CLI, dan bot dinonaktifkan sementara karena spam.
\n\n\n[!TIP]\nSoon: Submisi via Discord & Telegram Bot!\nKami sedang membangun integrasi bot agar kamu bisa mengirimkan bansos baru secara otomatis langsung dari server Discord atau channel Telegram.\nSembari menunggu, yuk gabung ke komunitas kami:
\n\n
\n- Discord Server untuk ngobrol, diskusi, dan submit via chat (coming soon).
\n- Telegram Channel untuk dapetin update instan promo developer terbaru langsung di HP-mu.
\n
Opsi ini sangat cocok buat kamu yang ingin berbagi info dengan cepat tanpa perlu menyentuh terminal.
\nSubmit publik via npx bansosdev add sedang dinonaktifkan sementara karena spam. Dokumentasi CLI tetap disimpan untuk maintainer dan pengujian lokal, tetapi jangan dipakai untuk submit publik saat ini.
npx bansosdev add\nCLI akan menuntunmu mengisi field demi field untuk menyiapkan data lokal.
\nKamu juga bisa mengirimkan data langsung menggunakan argumen CLI:
\nnpx bansosdev add \\\n --id contoh-bansos \\\n --title \"Contoh Bansos Developer\" \\\n --provider \"Example Provider\" \\\n --description \"Deskripsi singkat bansos.\" \\\n --benefits \"Benefit satu|Benefit dua\" \\\n --validity-type fixed \\\n --validity-date 2026-06-30 \\\n --validity-desc \"Berlaku khusus pelajar\" \\\n --published-at 2026-06-13 \\\n --requirements \"Buat akun|Klaim program\" \\\n --cta-link \"https://example.com\" \\\n --contributor-name \"Nama Kamu\" \\\n --contributor-url \"https://example.com\" \\\n --tags \"Cloud,Gratisan\"\n--validity-type wajib: pilih fixed, uncertain, atau forever.--validity-date wajib jika --validity-type fixed, memakai format YYYY-MM-DD (Berfungsi sebagai Tanggal Berakhir).--validity-desc opsional untuk catatan masa berlaku, kuota, atau syarat khusus.--published-at opsional untuk tanggal mulai berlaku (start date) dalam format YYYY-MM-DD. Default adalah hari ini.--source opsional untuk sumber verifikasi; bisa berupa URL atau teks biasa.\n\nCatatan Otomatisasi:
\n\n
\n- Parameter
\nproviderakan diekstrak secara otomatis dari domaincta-link.- Parameter
\nstatusakan dihitung otomatis (active,upcoming, atauexpired) berdasarkan tanggalpublished-atdanvalidity-date.
npx bansosdev add ... --mode json\nOpsi ini bagi kamu yang ingin menguji kode secara lokal atau memodifikasi file secara langsung.
\nClone repositori ini ke komputermu:
\ngit clone https://gitlab.com/wauputr4/bansos.git\ncd bansos\nnpm install\nTambahkan data secara lokal menggunakan helper script:
\nnpm run add:bansos -- \\\n --id contoh-bansos \\\n --title \"Contoh Bansos Developer\" \\\n --provider \"Example Provider\" \\\n --description \"Deskripsi singkat bansos.\" \\\n --benefits \"Benefit satu|Benefit dua\" \\\n --validity-type fixed \\\n --validity-date 2026-06-30 \\\n --requirements \"Buat akun|Klaim program\" \\\n --cta-link \"https://example.com\" \\\n --contributor-name \"Nama Kamu\" \\\n --contributor-url \"https://example.com\" \\\n --tags \"Cloud,Gratisan\"\nScript ini akan memvalidasi data dan menyimpannya di file data terstruktur src/lib/data/bansos.json.
Argumen --benefits dan --requirements dipisahkan dengan |.\nArgumen --tags dipisahkan dengan koma.
Buat branch baru, tambahkan commit, push ke fork, dan kirim merge request ke repositori utama.
\nMode direct untuk submit otomatis sedang dinonaktifkan. Untuk perubahan maintainer, gunakan Git clone, commit manual, dan merge request ke main.
npx bansosdev add ... --mode json\nPerintah di atas hanya untuk mengecek payload JSON secara lokal.
\nDetail lengkap CLI lihat docs/bansosdev-cli.md.
\nListing yang baik sebaiknya menyertakan:
\nCloud, Domain, AI Credits, Startup, atau No Credit Card.Ikuti Code of Conduct.
\nProyek bansos.dev dibangun secara gratis oleh komunitas. Jika proyek ini membantumu menghemat budget developer-mu, silakan kirim dukungan via email ke me@wau.my.id.
\n\n[!NOTE]\nSoon: Kami berencana menghadirkan fitur di mana donatur/pengunjung bisa mengirimkan dukungan (donasi) langsung ke masing-masing kontributor yang mendaftarkan/menulis listing bansos tersebut.
\n
MIT. Lihat LICENSE.
\nbansos.dev adalah platform komunitas open-source yang bertujuan membantu sesama developer Indonesia menemukan program bantuan sosial yang sah dan legal dari provider resmi. Kami tidak terafiliasi dengan provider mana pun.
\nKami dengan tegas melarang:
\nSemua informasi yang ditampilkan bersifat referensi. Selalu verifikasi langsung ke situs resmi provider sebelum melakukan klaim. Kami tidak bertanggung jawab atas perubahan kebijakan sepihak dari provider, interpretasi manfaat yang keliru, ataupun penyalahgunaan informasi oleh pihak tidak bertanggung jawab.
\nDengan menggunakan bansos.dev, Anda menyetujui bahwa platform ini hanyalah katalog komunitas dan segala klaim, transaksi, atau interaksi dengan provider sepenuhnya merupakan tanggung jawab pribadi masing-masing pengguna.
\n" }, + { + "fullName": "giosakti/duragent", + "name": "duragent", + "owner": "giosakti", + "ownerAvatarUrl": "https://avatars.githubusercontent.com/u/524078?v=4", + "description": "Durable agent runtime. Sessions survive crashes. Agents are just files. One binary, zero dependencies.", + "metaDescription": "Durable agent runtime. Sessions survive crashes. Agents are just files. One binary, zero dependencies.", + "url": "https://github.com/giosakti/duragent", + "homepage": "http://docs.duragent.ai/", + "language": "Rust", + "stars": 48, + "forks": 2, + "topics": [], + "updatedAt": "2026-06-25T07:10:40Z", + "pushedAt": "2026-02-18T08:47:11Z", + "latestRelease": { + "name": "v0.5.4", + "tagName": "v0.5.4", + "url": "https://github.com/giosakti/duragent/releases/tag/v0.5.4", + "publishedAt": "2026-02-18T09:07:37Z" + }, + "archived": false, + "licenseSpdx": "MIT", + "createdAt": "2026-01-11T07:23:01Z", + "openIssues": 0, + "openPullRequests": 0, + "subscribers": 1, + "communityHealth": 100, + "readmeHtml": "\n
\n\nDuragent โ A durable, self-contained runtime for AI agents.
\n
Sessions survive crashes. Agents are just files. One binary, zero dependencies.
\nUse it as a personal AI assistant, or as the foundation for agent-powered products.
\n| What you get | \nHow | \n
|---|---|
| Sessions that survive crashes | \nAppend-only event log, attach/detach like tmux | \n
| Agents you can read and version | \nYAML + Markdown โ no code required | \n
| State you can inspect | \nJust files on disk โ cat, grep, git diff | \n
| Deploy anywhere | \nSingle binary, ~10MB, no Python/Node/Docker | \n
| Your choice of parts | \nSwap LLM providers, gateways, and storage backends or bring your own | \n
Download a prebuilt binary from GitHub Releases (Linux x86_64, macOS Intel/ARM), or build from source:
\ncargo install --git https://github.com/giosakti/duragent.git\n\nduragent init\n# Follow the interactive setup\nexport OPENROUTER_API_KEY=your-key # or: duragent login anthropic\nduragent chat --agent <YOUR_AGENT_NAME>\nduragent attach --list # List attachable sessions\nduragent attach SESSION_ID # Reconnect to existing session\nduragent doctor for diagnostics, duragent upgrade for self-updateUse the built-ins, or swap in your own:
\n| Component | \nDefault | \nSwappable | \n
|---|---|---|
| Gateways | \nCLI, HTTP, SSE, Telegram, Discord | \nAny platform via gateway plugins | \n
| LLM | \nOpenRouter | \nAnthropic, OpenAI, Ollama, or any provider | \n
| Sandbox | \nTrust mode | \nbubblewrap, Docker (planned) | \n
| Storage | \nFilesystem | \nPostgres, S3 (planned) | \n
./.duragent/\nโโโ agents/<agent-name>/\nโ โโโ agent.yaml # Agent definition (Duragent Format)\nโ โโโ SOUL.md # \"Who the agent IS\" (identity and personality)\nโ โโโ SYSTEM_PROMPT.md # \"What the agent DOES\" (core system prompt)\nโ โโโ INSTRUCTIONS.md # Additional runtime instructions (optional)\nโ โโโ policy.yaml # Tool execution policy (optional)\nโ โโโ skills/ # Modular capabilities (SKILL.md files)\nโ โโโ tools/ # Agent-specific auto-discovered tools\nโ โโโ memory/\nโ โโโ MEMORY.md # Curated long-term memory\nโ โโโ daily/ # Daily experience logs\nโโโ sessions/\nโ โโโ <session_id>/\nโ โโโ events.jsonl # Append-only event log\nโ โโโ state.json # Snapshot for fast resume\nโโโ tools/ # Workspace-level auto-discovered tools\nโโโ schedules/ # Scheduled tasks and run logs\nโโโ processes/ # Background process metadata and logs\nโโโ memory/\n โโโ world/ # Shared knowledge across all agents\nRead the Duragent Guide for installation, configuration, and usage.
\nFor contributors: CONTRIBUTING.md | Project Status | Internal Specs
\nCurrent version: 0.3.74
\n![\"Rust\"](\"https://img.shields.io/badge/Rust-1.85-orange?logo=rust&logoColor=white\"){kind=icon}
![\"PostgreSQL\"](\"https://img.shields.io/badge/PostgreSQL-16-4169E1?logo=postgresql&logoColor=white\"){kind=icon}
![\"MCP\"](\"https://img.shields.io/badge/MCP-1.29-green?logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIyNCIgaGVpZ2h0PSIyNCIgdmlld0JveD0iMCAwIDI0IDI0IiBmaWxsPSJub25lIiBzdHJva2U9IndoaXRlIiBzdHJva2Utd2lkdGg9IjIiPjxwYXRoIGQ9Ik0xMiAydjIwTTIgMTJoMjAiLz48L3N2Zz4=\"){kind=icon}
![\"License:](\"https://img.shields.io/badge/License-MIT-yellow.svg\"){kind=icon}
Unified AI coding agent platform built on Model Context Protocol (MCP) โ Rust Implementation
\n\n\nMigration Status: Complete. Backend migrated from TypeScript to Rust.
\n
This is the Rust implementation of masday-workflow, providing a robust, type-safe backend with the MCP protocol. The project combines a multi-agent workflow system with 4-layer memory (working, episodic, long-term, graph) and exposes MCP tools for AI agents.
\nOne-line install (Linux/macOS/Windows Git Bash):
\ncurl -fsSL https://github.com/dayartcrew-web/masday-workflow-rust/releases/latest/download/install.sh | bash\nAuto-detects: Linux / macOS / Windows ร x86_64 / aarch64
\nManual download: Linux x86_64 ยท Windows x86_64 ยท All releases
\n๐ Full install guide: docs/install-guide.md
\nmasday quickstart # One-command setup (db + agents + MCP)\nmasday --version # Check version\nmasday status # Check health\n# Clone and setup\ngit clone <repo-url>\ncd masday-workflow-rust\nbash scripts/setup.sh\n\n# Build Rust crates\ncargo build --workspace\n\n# Run MCP server (exposes tools via stdio, uses SQLite โ no database setup needed)\ncargo run -p masday-mcp\n\n# Run API server (REST endpoints, requires PostgreSQL)\nDATABASE_URL=postgresql://USER:PASS@localhost:54341/masday_workflow \\\n cargo run -p masday-api\n\n# Build release binaries\ncargo build --release --workspace\n\n\nNote: The MCP stdio server (
\nmasday-mcp) runs in SQLite-only mode โ it creates~/.masday/data.dbautomatically. No PostgreSQL or API server required for local use. PostgreSQL is only needed for the API server (masday-api) or remote deployments.
โโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ\nโ MCP Client โโโโโ>โ masday-mcp (standalone binary) โ\nโ (Claude/etc)โstdioโ โโโโโโโโโโโโ โโโโโโโโโโโโโโโโ โ\nโโโโโโโโโโโโโโโโ โ โ 20 Tool โ โ SQLite โ โ\n โ โ Domains โโโโ ~/.masday/ โ โ\n โ โโโโโโโโโโโโ โ data.db โ โ\n โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ\nโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโ\nโ MCP Client โโโโโ>โ API Server (masday-api) โโโโโ>โ PostgreSQL โ\nโ (Claude/etc)โHTTP โ (Axum) โ โ โ\nโโโโโโโโโโโโโโโโ โ โ โโโโโโโโโโโโโโโ\n โ โโโโโโโโโโ โโโโโโโโโโโโโ โ\nโโโโโโโโโโโโโโโโ โ โService โ โ 20 Tool โ โ โโโโโโโโโโโโโโโ\nโ Dashboard โโโโโ>โ โ Layer โ โ Domains โ โโโโโ>โ Redis Cache โ\nโ (Next.js) โHTTP โ โโโโโโโโโโ โโโโโโโโโโโโโ โ โโโโโโโโโโโโโโโ\nโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ\nRemote mode env vars (API server only):
\nDATABASE_URL=\"postgresql://USER:PASS@localhost:54341/masday_workflow\"\nMASDAY_API_KEY=\"your-api-key\"\n| Crate | \nDescription | \n
|---|---|
| masday-core | \nShared types, errors, constants | \n
| masday-db | \nRepository layer (sqlx, PostgreSQL, deadpool) | \n
| masday-service | \nBusiness logic (workflow, memory, policy, capability) | \n
| masday-api | \nHTTP API layer (Axum, REST endpoints) | \n
| masday-mcp | \nMCP server (stdio/local: 70 tools; HTTP/remote: 92 tools; SQLite + PostgreSQL) | \n
| masday-cli | \nCommand-line interface | \n
Masday uses a 3-layer persistence architecture:
\n~/.claude/projects/<project>/memory/\nโโโ MEMORY.md โ Index (auto-loaded every session)\nโโโ decision-name.md โ Individual memory files\nโโโ another-fact.md\nname, description, metadata.type)MEMORY.md = table of contents loaded into context at every session startWrite tool, not MCPmemory_* tools)Local: ~/.masday/data.db โ table: memories\nRemote: PostgreSQL โ table: memories (with pgvector)\nmcp__masday__memory_store, memory_search, memory_recallhash(text) โ [f32; 768] โ non-cryptographic hash functionsORDER BY embedding <=> $query_vector โ indexable with IVFFlat/HNSWsimilarityร0.6 + importanceร0.2 + recencyร0.1 + usageร0.1graph_* tools)Local: ~/.masday/data.db โ tables: graph_nodes, graph_edges\nRemote: PostgreSQL โ tables: graph_nodes, graph_edges\n +----------------------------------------------------------+\n | WORKING MEMORY |\n | In-process RAM, per session |\n +----------------------------------------------------------+\n |\n +----------------------------------------------------------+\n | EPISODIC MEMORY |\n | Last N messages per session |\n | Persisted to EpisodicMemory table |\n +----------------------------------------------------------+\n |\n +----------------------------------------------------------+\n | LONG-TERM MEMORY |\n | Scoring: similarityร0.6 + importanceร0.2 |\n | + recencyร0.1 + usageร0.1 |\n | Memory table (SQLite BLOB or PostgreSQL pgvector) |\n +----------------------------------------------------------+\n |\n +----------------------------------------------------------+\n | KNOWLEDGE GRAPH |\n | Nodes & edges, auto-linked |\n | GraphNode + GraphEdge tables |\n +----------------------------------------------------------+\n| Mode | \nVectorizer | \nStorage | \nSearch | \nScale | \n
|---|---|---|---|---|
| Local (SQLite) | \nFeature hashing (768-dim) | \nBLOB column | \nRust brute-force cosine | \n~100s | \n
| Remote (PostgreSQL) | \nONNX nomic-embed-text or OpenAI | \npgvector column | \nORDER BY <=> (IVFFlat/HNSW index) | \n~millions | \n
INIT --> ANALYZE --> PLAN --> EXECUTE --> VERIFY --> DONE\n | | | | |\n |--> DONE | | |--> FIX --|\n |--> FAILED | |--> PAUSED |--> FIX --> EXECUTE\n |--> FAILED |\n |--> FAILED\n FIX --> DONE\n FIX --> FAILED\nThe masday-mcp crate exposes 70 tools in stdio/local mode (masday mcp, SQLite) and 92 tools in HTTP/remote mode (via masday-api, PostgreSQL). The per-domain counts below are the HTTP/remote superset; stdio mode registers a subset of each domain.
| Namespace | \nTools | \nDescription | \n
|---|---|---|
| workflow | \n23 | \nWorkflow lifecycle, tasks, plans, parallel branches | \n
| memory | \n11 | \n4-layer memory (working, episodic, long-term, graph) | \n
| semantic-search | \n3 | \nContext packs, code search, fingerprinting | \n
| policy | \n6 | \nValidation, drift detection, workflow audit | \n
| capability | \n11 | \nAgent/skill registry, system health, scaffolding | \n
| filesystem | \n5 | \nFile operations (read, write, list, delete) | \n
| review | \n2 | \nReview submission, decision tracking | \n
| session | \n3 | \nSession state management | \n
| local | \n4 | \nLocal file-based state (.masday/) | \n
| git | \n3 | \nGit operations | \n
| npm | \n2 | \nPackage manager operations | \n
| docker | \n3 | \nDocker operations | \n
| cicd | \n3 | \nCI/CD operations | \n
| github | \n3 | \nGitHub operations | \n
| tests | \n1 | \nTest runner | \n
| reminder | \n3 | \nStale/stuck workflow detection | \n
masday setup # Interactive setup wizard (first-time)\nmasday quickstart # One-command setup: db + migrate + install + ready\nmasday install # Install masday into current project\nmasday install --force # Force overwrite existing configs\nmasday install --standalone # Standalone mode โ templates only, no build\nmasday install --remote URL # Connect to remote API server\nmasday install --skip-build # Skip cargo build, use existing binaries\nmasday uninstall # Remove masday from current project\nmasday update # Download latest binary from GitHub Releases\n # Copies to ~/.masday/bin/, re-syncs config\nmasday status # Check health of all services\nmasday serve # Start API server + dashboard (port 30101)\nmasday serve --port 8080 # Start on custom port\nmasday mcp # Start MCP server (stdio โ used by AI platforms)\nmasday db start # Start PostgreSQL and Redis containers\nmasday db stop # Stop all containers\nmasday db reset # Delete data and recreate containers\nmasday embed setup # Download ONNX Runtime + default model\nmasday embed setup --model bge-small-en-v1.5 # Download specific model\nmasday embed status # Show embedding setup status\nmasday embed remove # Remove all embedding artifacts\nmasday embed remove --models-only # Remove models, keep ONNX Runtime\nSupported models:
\n| Model | \nDimensions | \nDescription | \n
|---|---|---|
all-MiniLM-L6-v2 (default) | \n384 | \nFast, good quality | \n
bge-small-en-v1.5 | \n384 | \nBGE small variant | \n
bge-base-en-v1.5 | \n768 | \nBGE base, higher quality | \n
# Build\ncargo build --workspace # Build all crates\ncargo build --release # Optimized release build\ncargo build -p masday-mcp # Build specific crate\n\n# Run\ncargo run -p masday-mcp # Start MCP server\ncargo run -p masday-api # Start API server\n\n# Test\ncargo test --workspace # Run all tests\ncargo test -p masday-service # Test specific crate\ncargo test -- --nocapture # Show test output\n\n# Lint\ncargo clippy --workspace -- -D warnings # Lint with warnings as errors\ncargo fmt --all # Format code\ncargo fmt --all -- --check # Check formatting\n\n# Clean\ncargo clean # Remove build artifacts\n# Build and release from project root (Linux + Windows)\nbash scripts/release.sh v0.3.74\n\n# Build Linux only\nbash scripts/release.sh v0.3.74 --linux-only\n\n# Test without uploading\nbash scripts/release.sh v0.3.74 --dry-run\n| Binary | \nLinux | \nWindows | \nSize | \n
|---|---|---|---|
| masday (CLI) | \nmasday-linux-x86_64 (39MB) | \nmasday-windows-x86_64.exe (15MB) | \nCLI + MCP server wrapper | \n
| masday-mcp (standalone) | \nmasday-mcp-linux-x86_64 (3.3MB) | \nmasday-mcp-windows-x86_64.exe (2.9MB) | \nLightweight MCP server | \n
\n\nNote: Windows binary is built without local ONNX embeddings. Use remote embedding provider (Ollama/OpenAI) on Windows.
\n
All config lives under ~/.masday/:
~/.masday/\nโโโ config.toml โ Configuration (auto-created by quickstart)\nโโโ bin/\nโ โโโ masday โ CLI binary\nโโโ data.db โ SQLite database (local mode, auto-created)\nRun masday quickstart for an interactive setup wizard:
The wizard automatically:
\n~/.masday/config.toml~/.masday/config.toml)mode = \"local\" # local | remote | standalone\napi_url = \"http://localhost:30101\"\napi_key = \"***\"\ndatabase_url = \"postgresql://USER:PASS@localhost:54341/masday_workflow\"\nembedding_provider = \"local\" # local | ollama | openai\nembedding_model = \"all-MiniLM-L6-v2\"\nembedding_dimensions = 384\nport = 30101\nplatforms = [\"claude-code\"]\nLocal mode (default) โ the MCP stdio server requires no configuration. It uses SQLite at ~/.masday/data.db automatically.
Remote mode โ only the API server needs env vars. MCP clients connect directly via HTTP/SSE:
\n# โโ API Server (masday-api) โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ\nDATABASE_URL=\"postgresql://USER:PASS@localhost:54341/masday_workflow\"\nMASDAY_API_KEY=\"your-api-key\" # Auth key for MCP clients\n\n# โโ Optional (both modes) โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ\nRUST_LOG=\"info\" # debug, info, warn, error\nRUST_BACKTRACE=\"1\" # Enable backtrace on panic\n\n\nNote: The MCP binary in local mode needs zero env vars. For remote deployments, skip the binary entirely and point MCP clients directly at the API server via HTTP/SSE.
\n
The masday-mcp binary runs standalone:
~/.masday/data.db (auto-created on first run)The scripts/setup.sh script generates MCP configuration files for different platforms:
.mcp.json.gemini/settings.json.vscode/mcp.jsonAll configurations point to the Rust MCP binary: target/debug/masday-mcp (or target/release/masday-mcp for release builds).
The masday binary wraps the MCP server โ run masday mcp to start. A separate lightweight masday-mcp binary is also available.
~/.masday/data.db (auto-created on first run)Download from GitHub Releases:
\n# Linux โ full CLI (includes MCP server)\ncurl -fsSL -o masday \\\n https://github.com/dayartcrew-web/masday-workflow-rust/releases/latest/download/masday-linux-x86_64\nchmod +x masday\n\n# Linux โ standalone MCP server only\ncurl -fsSL -o masday-mcp \\\n https://github.com/dayartcrew-web/masday-workflow-rust/releases/latest/download/masday-mcp-linux-x86_64\nchmod +x masday-mcp\n\n# Windows PowerShell\nInvoke-WebRequest -Uri \"https://github.com/dayartcrew-web/masday-workflow-rust/releases/latest/download/masday-windows-x86_64.exe\" -OutFile \"masday.exe\"\nFor stdio mode (recommended โ SQLite, no external services needed):
\n{\n \"mcpServers\": {\n \"masday\": {\n \"type\": \"stdio\",\n \"command\": \"/path/to/masday-mcp\"\n }\n }\n}\nNo environment variables needed โ the binary creates ~/.masday/data.db on first run.
For remote deployments (no MCP binary needed โ point directly to API server):
\n{\n \"mcpServers\": {\n \"masday\": {\n \"url\": \"http://localhost:30101/mcp\"\n }\n }\n}\nThe MCP stdio binary (masday-mcp) uses SQLite for persistence. No setup required.
~/.masday/data.db# Check your database\nsqlite3 ~/.masday/data.db \".tables\"\nThe API server (masday-api) uses PostgreSQL 16 with pgvector for multi-user deployments.
# Start PostgreSQL with pgvector\ndocker-compose up -d\n\n# Run migrations\ncargo run -p masday-db -- migrate\nworkflows โ Workflow instancestasks โ Task instancesplans โ Workflow plansmemories โ Long-term memoriesepisodic_memories โ Episodic memoriesgraph_nodes / graph_edges โ Knowledge graphreview_decisions โ Review decisionssession_states โ Session stateworkflow_reminders โ Stale/stuck remindersparallel_branches โ Parallel execution branches| Layer | \nTechnology | \n
|---|---|
| Language | \nRust (2021 edition) | \n
| Runtime | \nTokio async runtime | \n
| Database | \nSQLite (stdio, local mode) / PostgreSQL 16 + pgvector (API, remote mode) | \n
| API | \nAxum (REST HTTP) | \n
| Protocol | \nModel Context Protocol (MCP) over stdio | \n
| Cache | \nRedis (optional) | \n
| Validation | \nSerde + serde_json | \n
| Logging | \ntracing | \n
| Testing | \nbuilt-in cargo test | \n
| CLI | \nclap 4.5 | \n
| Error Handling | \nthiserror (lib) + anyhow (app) | \n
masday-core/src/types.rsmasday-db/src/repos/masday-service/src/masday-api/src/routes/masday-mcp/src/tools/masday-mcp/src/main.rstests/ module# Unit tests (all crates)\ncargo test --workspace\n\n# Integration tests\ncargo test --workspace --test '*_integration'\n\n# With output\ncargo test --workspace -- --nocapture\n\n# Specific test\ncargo test -p masday-service test_workflow_create\n# Format all code\ncargo fmt --all\n\n# Check formatting (CI)\ncargo fmt --all -- --check\n\n# Lint with clippy\ncargo clippy --workspace -- -D warnings\n\n# Fix clippy warnings\ncargo clippy --workspace --fix\n| Platform | \nAgents | \nSkills | \nMCP Config | \nLocation | \n
|---|---|---|---|---|
| Claude Code | \n.claude/agents/*.md | \n.claude/skills/*/SKILL.md | \n.mcp.json | \nProject root | \n
| Gemini CLI | \n.gemini/agents/ | \n.gemini/skills/ | \n.gemini/settings.json | \n~/.gemini/ | \n
| VS Code Copilot | \n.github/agents/ | \nN/A | \n.vscode/mcp.json | \nProject root | \n
| OpenCode | \n.opencode/agent/ | \n.opencode/skills/ | \nCustom | \n~/.config/opencode/ | \n
Run bash scripts/setup.sh to install to all platforms.
This project was migrated from a TypeScript monorepo to Rust. The migration is complete:
\npackages/* (13 TypeScript packages)apps/agent-runner (TypeScript MCP server)apps/api (Express API)apps/desktop (Electron desktop app)pnpm-workspace.yaml (multi-package workspace)turbo.json (Turborepo build)vitest.config.ts (Vitest tests)masday-core โ replaces packages/core, packages/shared-utilsmasday-db โ replaces packages/db, packages/storemasday-service โ replaces packages/workflow-engine, packages/memory, packages/policy, etc.masday-api โ replaces apps/api (Express)masday-mcp โ replaces apps/agent-runner (MCP server)masday-cli โ replaces packages/cliapps/dashboard โ Next.js frontend (still actively used)| Benefit | \nTypeScript โ Rust | \n
|---|---|
| Type Safety | \nRuntime type errors โ Compile-time guarantees | \n
| Performance | \nSingle-threaded event loop โ Multi-core Tokio | \n
| Database | \nDrizzle runtime checks โ sqlx compile-time checks | \n
| Memory | \nJSON fallback โ Proper API error handling | \n
| Connections | \nStale connections โ deadpool with health checks | \n
git checkout -b feat/my-feature)cargo fmt must passcargo clippy must pass with no warningscargo test)Result<T, E> for error handlingsnake_case for functions/modules, PascalCase for typesthiserror for library errors, anyhow for app errorstokio runtime, #[tokio::test] for async testsserde derive for all types crossing boundaries# Clear build cache\ncargo clean\n\n# Update dependencies\ncargo update\n\n# Check Rust version\nrustc --version # Should be 1.85+\n# Check PostgreSQL is running (API server mode only)\ndocker-compose ps\n\n# Check DATABASE_URL in .env\necho $DATABASE_URL\n\n# Test connection\npsql $DATABASE_URL\n# Check binary exists\nls -la target/debug/masday-mcp\n\n# Build if missing\ncargo build -p masday-mcp\n\n# Check logs\nRUST_LOG=debug cargo run -p masday-mcp\n\n# Verify SQLite database\nsqlite3 ~/.masday/data.db \".tables\"\nBuilt on top of outstanding open source software:
\n![\"OMNI](\"https://raw.githubusercontent.com/fajarhide/omni/main/media/logo.png\"){kind=logo}
\n Noise-canceling context and long-term memory for your AI agent. Stop paying Claude to read 10,000 lines of terminal noise like a headphone for AI agent\n
๐บ๐ธ English | ๐ฏ๐ต ๆฅๆฌ่ช | ๐จ๐ณ ็ฎไฝไธญๆ | ๐ธ๐ฆ ุงูุนุฑุจูุฉ | ๐ฎ๐ฉ Bahasa Indonesia | ๐ป๐ณ Tiแบฟng Viแปt | ๐ฐ๐ท ํ๊ตญ์ด
\n![\"CI\"](\"https://github.com/fajarhide/omni/actions/workflows/ci.yml/badge.svg\"){kind=icon}
\n![\"Release\"](\"https://img.shields.io/github/v/release/fajarhide/omni\")
![\"Rust\"](\"https://img.shields.io/badge/built_with-Rust-dca282.svg\"){kind=icon}
\n ![\"MCP\"](\"https://img.shields.io/badge/MCP-compatible-green.svg?style=flat-square\"){kind=icon}
\n ![\"License:](\"https://img.shields.io/github/license/fajarhide/omni\")
![\"Hits\"](\"https://hits.sh/github.com/fajarhide/omni.svg\")
\n
\n\nUp to 85% less tokens ยท Cross-Session Memory ยท ~40% faster ยท Zero hallucination triggers
Every AI coding assistant has two massive problems.
\n1. They read everything.
Build logs.
Docker logs.
CI logs.
Progress bars.
ANSI colors.
Thousands of tokens... to find one line. Claude isn't expensive. Your terminal is.
2. They forget everything.
Every time you restart Cursor, or switch from Claude Code to Windsurf, your agent gets amnesia. You have to re-explain the project goal. You have to remind them of the same framework gotchas over and over again.
OMNI fixes both.
\nProblem 1: Your terminal drowns out the signal
\nnpm installWithout OMNI: 10,000 lines of \"Downloading...\", \"Extracting...\", and warnings. AI reads everything.
With OMNI: Package conflict. Node 20 required.
terraform applyWithout OMNI: 4,500 lines of unchanged execution plans.
With OMNI: The 3 resources that failed IAM permissions.
docker buildWithout OMNI: Endless cache hits, layer hashes, and download progress bars.
With OMNI: Missing dependency libpq-dev at layer 12.
pytestWithout OMNI: 500 passing tests and verbose setup logs.
With OMNI: Only the 2 failed assertions and their stack traces.
cargo buildWithout OMNI: 300 lines of compiling dependencies and warnings.
With OMNI: The exact line where the borrow checker failed.
kubectl logsWithout OMNI: Thousands of successful health checks and normal traffic logs.
With OMNI: The crash loop and panic stack trace.
git diffWithout OMNI: Formatting tweaks, generated lockfiles, and whitespace changes.
With OMNI: Only the core business logic changes.
go testWithout OMNI: Pages of standard output from passing packages.
With OMNI: The single nil pointer dereference.
mvn packageWithout OMNI: Megabytes of \"Downloading from maven central\".
With OMNI: Compilation error in UserService.java.
pip installWithout OMNI: Resolution logs and wheel building outputs.
With OMNI: Dependency conflict with numpy.
webpack / viteWithout OMNI: 2,000 chunk asset lists and build times.
With OMNI: Missing module resolution in App.tsx.
helm installWithout OMNI: Entire rendered YAML output of all templates.
With OMNI: Pod scheduling failure due to missing secret.
ansible-playbookWithout OMNI: \"ok\" and \"skipped\" statuses for 50 servers.
With OMNI: The single \"failed\" task on web-03.
Without OMNI: Complete workflow logs including environment setup.
With OMNI: Only the specific step that exited with code 1.
Problem 2: Your agent forgets everything overnight
\nWithout OMNI: \"Please re-explain the project structure, the auth module is broken, and we use Postgres not MySQL.\"
With OMNI: The agent already knows. It picks up where you left off.
Without OMNI: Agent hits the same framework gotcha it already solved yesterday because it has no memory.
With OMNI: The fix is already stored. omni recall surfaces the exact solution in under 10ms.
Without OMNI: New IDE, new agent, zero context. You're starting from scratch.
With OMNI: Session summary is injected automatically. New agent is immediately up to speed.
The code you don't send to the AI is just as important as the code you do.
\nWhen you feed an AI megabytes of terminal noise, it suffers from context bloatโhallucinating fixes for the wrong warnings and burning your API budget on irrelevant output.
\nWhen you restart an agent and it has no memory, you lose hours re-establishing context that should have been preserved automatically.
\nOMNI solves both, invisibly:
\nThe honest headline, measured on the release binary against 1,810 real command\nexecutions replayed from one developer's actual usage:
\nThat second bullet is the number most tools in this category do not print. A tool\nthat claims to save 90% of every command is telling you it summarises output you\nneeded.
\n![\"OMNI\"](\"https://omni.weekndlabs.com/media/performance.png\")
\nWhere the saving actually comes from, over the same 1,810 executions:
\n| Command | \nCalls | \nInput | \nOutput | \nSaved | \n
|---|---|---|---|---|
cargo | \n29 | \n424 KB | \n13 KB | \n96.8% | \n
git | \n256 | \n5.9 MB | \n509 KB | \n91.3% | \n
ls | \n52 | \n71 KB | \n29 KB | \n59.5% | \n
kubectl | \n212 | \n4.4 MB | \n2.3 MB | \n48.0% | \n
find | \n39 | \n83 KB | \n53 KB | \n36.2% | \n
grep | \n184 | \n534 KB | \n385 KB | \n27.8% | \n
cat | \n85 | \n515 KB | \n468 KB | \n9.1% | \n
git and cargo carry the result; cat and grep are close to a no-op. OMNI\nearns its place on noisy, repetitive tooling output and gets out of the way\neverywhere else.
Single fixtures from tests/fixtures/, if you want to reproduce one by hand:
| Command / Context | \nInput | \nOutput | \nSaved | \n
|---|---|---|---|
cargo build (large, successful) | \n3,220 B | \n9 B | \n99.7% | \n
cargo test (490 passed, 10 failed) | \n16.5 KB | \n1,100 B | \n93.3% | \n
pytest (failures) | \n730 B | \n136 B | \n81.4% | \n
git status (dirty) | \n496 B | \n113 B | \n77.2% | \n
git diff (multi-file) | \n397 B | \n220 B | \n44.6% | \n
docker build (heavy noise) | \n9.2 KB | \n5.8 KB | \n37.2% | \n
kubectl get pods (mixed) | \n840 B | \n762 B | \n9.3% | \n
Latency is a real cost, not zero. OMNI runs on every hooked command, and the\nprice grows with your history: a 496-byte git status takes ~82 ms against a\nfresh database and ~308 ms against a 97 MB one. A 16.5 KB cargo test takes\n~276 ms. Budget for it.
To see your own actual token savings, just run omni stats after a few days of usage.
Omni is incredibly easy to set up. It natively integrates into your terminal.
\nmacOS / Linux:
\n# 1. Install via Homebrew\nbrew install fajarhide/tap/omni\n\n# 2. Setup Omni (Interactive Menu for Claude, VS Code, OpenCode, Codex, Antigravity)\nomni init\n\n# 3. Verify it's working\nomni doctor\n\n# 4. Or auto-fix any issues\nomni doctor --fix\n\n# 5. Check Current Status\nomni init --status\nUniversal Installer (macOS / Linux / WSL):
\ncurl -fsSL omni.weekndlabs.com/install | bash\nWindows (PowerShell):
\nirm omni.weekndlabs.com/install.ps1 | iex\nOMNI works seamlessly with the agentic tools you already use. It intercepts their terminal executions automatically.
\nOMNI isn't just a terminal filterโit's a cure for AI amnesia.
\nIf you've ever worked with an AI agent for more than an hour, you know the pain of context loss. You restart the agent, and suddenly it forgets what you were working on. It forgets the project goal. It starts making the exact same mistakes it made yesterday because it forgot the repository's undocumented quirks.
\nOMNI's Memory OS runs silently in the background to solve this:
\nomni goal): Set your North Star objective once. OMNI will relentlessly remind the agent of this exact priority on every single prompt, preventing it from drifting off-task.omni remember): Stop fixing the same hallucination. Agents can save project-specific rules, gotchas, and architecture decisions directly into OMNI's local SQLite backend. When they get stuck later, they automatically pull the exact answer back out via semantic search.Your agent gets smarter about your codebase every single day, and you never have to repeat yourself again.
\nOmni operates purely locally using a deterministic Read โ Guard โ Score โ Collapse โ Distill โ Persist pipeline.
flowchart LR\n Command[Raw Tool Output] --> Hook[Omni Hook]\n Hook --> Score[Scorer Engine]\n Score -->|Critical=1.0, Noise=0.1| Distill[Content Distiller]\n Distill --> Clean[Clean Context]\n Command --> SQLite[(RewindStore SQLite)]\nIf the AI really needs the dropped noise, OMNI's local SQLite RewindStore keeps the full uncompressed log safely hashed, allowing the agent to retrieve it anytime.
\n![\"OMNI](\"https://raw.githubusercontent.com/fajarhide/omni/main/media/architecture.svg\")
\nBuilt in Rust for imperceptible latency.
\n# Development\ncargo build --release\ncargo test --all\nmake fmt && make clippy\nDoes Omni permanently delete my logs?
No. The raw logs are compressed and stored locally in the SQLite RewindStore. The AI receives a hash and can retrieve the full log if needed.
Will this slow down my terminal?
No. OMNI is written in Rust and executes the distillation pipeline in under 10ms.
Can I add my own filters?
Yes. You can teach OMNI to strip noise specific to your internal tools using TOML:
# ~/.omni/signals/custom.toml\n[filters.my_tool]\nmatch_command = \"^internal-tool\\\\b\"\nstrip_lines_matching = [\"^DEBUG\", \"syncing...\"]\nThis is a passion project built for the era of Agentic AI. Whether you're here to save money on tokens, test out free models, or help build the ultimate agentic toolbelt, contributions are always welcome!
\nmake ci and cargo build. Read our CONTRIBUTING.md for details.\n \n \n \n \n \n \n \n