{"id":31544458,"url":"https://github.com/roma-glushko/frens","last_synced_at":"2025-10-04T13:16:38.514Z","repository":{"id":304851397,"uuid":"912438559","full_name":"roma-glushko/frens","owner":"roma-glushko","description":"🤝 Build friendships that last. ","archived":false,"fork":false,"pushed_at":"2025-09-14T18:04:38.000Z","size":580,"stargazers_count":2,"open_issues_count":16,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-14T18:25:18.882Z","etag":null,"topics":["cli","connections","crm","dairy","family","friends","friendship","golang-application","journal","journaling","network","people","relationships","tags"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/roma-glushko.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-01-05T15:23:56.000Z","updated_at":"2025-09-14T18:04:40.000Z","dependencies_parsed_at":"2025-07-16T14:57:07.087Z","dependency_job_id":"4ee46fce-8c42-47a2-859f-63318a53b1ea","html_url":"https://github.com/roma-glushko/frens","commit_stats":null,"previous_names":["roma-glushko/frens"],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/roma-glushko/frens","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roma-glushko%2Ffrens","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roma-glushko%2Ffrens/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roma-glushko%2Ffrens/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roma-glushko%2Ffrens/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/roma-glushko","download_url":"https://codeload.github.com/roma-glushko/frens/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roma-glushko%2Ffrens/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278317106,"owners_count":25967082,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-04T02:00:05.491Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","connections","crm","dairy","family","friends","friendship","golang-application","journal","journaling","network","people","relationships","tags"],"created_at":"2025-10-04T13:16:37.665Z","updated_at":"2025-10-04T13:16:38.507Z","avatar_url":"https://github.com/roma-glushko.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Frens\n\nA friendship management \u0026 journaling application for introverts and not only.\nBuild relationships with people that last.\n\n`frens` is a command-line application that helps you to keep track of your relationships \nwith other people you care about.\n\n`frens` gives you:\n\n- An organized and systematic way around staying in touch with friends and family.\n- A low-effort way to record and remember big moments in your life.\n- A way to track how your relationships develop over time.\n\n\u003e [!NOTE]\n\u003e\n\u003e 🚧 **This project is under active development, so some CLI or behaviors may change.** 🚧\n\n## Features\n\n- Record your relationships with friends, family, colleagues, and acquaintances using a simple set of concepts like `Friends`, `Locations`, `Activities`, and `Notes`.\n- A simple journaling language (called `frentxt`) to simplify the process of recording your thoughts and activities.\n\n## Philosophy\n\n- **Simplicity**: Should be quick and easy to use. As few concepts as possible to keep in mind. Little to no manual record maintenance.\n- **Journaling First**: Should focus you on journaling and jotting down your thoughts.\n- **Intelligence**: Guessing your friends' names, understanding relative dates (e.g. \"yesterday\", \"tomorrow\").\n- **Privacy \u0026 Transparency**: All data is stored locally on your machine in TOML file format. You can optionally share it across your laptops via Git.\n- **Hackable**: Should be possible to use the collected data in automations and scripts.\n\n## Installation\n\n### MacOS\n\n```bash\nbrew tap roma-glushko/frens https://github.com/roma-glushko/frens\nbrew install frens\n```\n\n### Download Binaries\n\nFor other platforms and architectures, you can download `frens`' binaries right from [Github Releases](https://github.com/roma-glushko/frens/releases).\n\n## Main Concepts\n\n![Diagram](./docs/friens-data-model.png?raw=true)\n\n- **Friends**: People you know and care about. Can be family, colleagues, or acquaintances.\n- **Locations**: Places where you and your friends live, work, or spend time together.\n- **Activities**: Things you do with your friends, like going to the movies, having dinner, or attending events.\n- **Notes**: Insights, preferences, deep meaning information with long-term value about your friends, activities, or locations.\n\n## Language\n\nOne of the major `fren`'s features is the ability to input all data as a free-form text \nusing a simple and straightforward syntax.\n\n### Tags\n\nTags are one of the common parts of other pieces of information like `Activities`, `Notes`, `Friends` or `Locations`.\n\nTags can be specified via the `#tag` syntax like this:\n\n```text\n#scool #family #university #school:math #school:physics #family-extended\n```\n\n### Locations\n\n`Locations` can be added like this:\n\n```text\nScranton, USA (aka \"The Electric City\") :: a great place to live and work #office @Scranton $id:scranton\n```\n\nThen, you can set location for your `Friends`, `Activities` and `Notes` via the `@location` syntax like this:\n\n```text\n@NewYork @LosAngeles @Scranton\n```\n\n### Friends\n\nSimilarly to `Locations`, the basic information about `Friend` can be added using a similar syntax:\n\n```text\nMichael Harry Scott (aka \"The World's Best Boss\"), my Dunder Mifflin boss, is a great friend of mine #office @Scranton\n```\n\nYou can also specify ID of the friend via `$id:friendid` syntax like this:\n\n```text\nMichael Harry Scott (aka \"The World's Best Boss\") $id:mscott, ...\n```\n\n### Activities \u0026 Notes\n\n`Activities` and `Notes` are events that have the same syntax:\n\n```text\nyesterday :: Jim put my stuff in jello #office @Scranton\n```\n\nYou can also completely omit the date, so it will be set to the current date:\n\n```text\nDwight bought a new beet farm #office @Scranton\n```\n\n## Credits\n\nInspired by awesome [JacobEvelyn/friends](https://github.com/JacobEvelyn/friends).\n\nMade with ❤️ by [Roman Glushko](https://github.com/roma-glushko).","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Froma-glushko%2Ffrens","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Froma-glushko%2Ffrens","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Froma-glushko%2Ffrens/lists"}