https://github.com/mkermani144/akc
A command-line tool for managing connections with friends.
https://github.com/mkermani144/akc
cli friendship
Last synced: 4 months ago
JSON representation
A command-line tool for managing connections with friends.
- Host: GitHub
- URL: https://github.com/mkermani144/akc
- Owner: mkermani144
- License: mit
- Created: 2022-03-08T20:18:32.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2026-02-25T18:35:52.000Z (4 months ago)
- Last Synced: 2026-02-25T21:24:23.555Z (4 months ago)
- Topics: cli, friendship
- Language: Rust
- Homepage:
- Size: 50.8 KB
- Stars: 5
- Watchers: 1
- Forks: 0
- Open Issues: 26
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# akc
[](https://justforfunnoreally.dev)
A command-line tool for managing connections with friends.
**This is still a work in progress. There may be lots of unexpected behaviors when you use it.**
# Table of contents
- [akc](#akc)
- [Table of contents](#table-of-contents)
- [History](#history)
- [Installation](#installation)
- [Usage](#usage)
- [Adding friends](#adding-friends)
- [Get suggestion for connection](#get-suggestion-for-connection)
- [Record a memory with a friend](#record-a-memory-with-a-friend)
- [TODO](#todo)
# History
`akc` is an acronym for "aji, ki, and chi". But what do those words mean?
They are terms some of my teammates and colleagues at the company use to refer to a friend with a specific level of closeness. An _aji_ is a very close friend. Then comes a _ki_ and finally a _chi_, indicating a close and normal friend, respectively.
_Note: In Persian, aji means sister (my teammates and colleagues who invented the terms are girls, so they used aji instead of male equivalent "dada", meaning brother in Persian), ki means who, and chi means what._
# Installation
You can download the executable for your platform in the [releases](https://github.com/mkermani144/akc/releases) page. In addition, if you have rust installed, you can install `akc` through `cargo`:
```
cargo install akc
```
# Usage
`akc` works by keeping your friends' names, suggesting you connect them based on their closeness. The closer and less suggested by `akc` they are, the more chance `akc` suggests you connect them. It's that simple.
Data is persisted in a local SQLite database.
By default, there are 3 levels of closeness as described in [history](#history), called aji (very close), ki (close), and chi (normal). In addition, there are 4 default connection methods: Hanging out, video call, call and text. These don't have an equal effect on the chance of the same friend being suggested again. If you hang out with a friend, `akc` will probably re-suggest him/her with far less probability than if you texted him/her. In other words, hanging out, video call, call, and text have the highest to lowest _cost_ respectively.
## Adding friends
```bash
akc friend aji Negar # Add an aji called Negar
akc friend ki Arash # Add a ki called Arash
akc friend chi Sara # Add a chi called Sara
```
## Get suggestion for connection
```bash
akc suggest # Suggest you a friend to connect with
```
## Record a memory with a friend
```bash
akc memory hangout Negar Sara # Record a hangout with Negar and Sara
akc memory video-call Arash # Record a video call with Arash
akc memory call Arash # Record a call with Arash
akc memory text Sara # Record a call with Arash
```
# TODO
- Add connection constraints
- Add a feature for changing defaults
- Add commands for listing friends and their connection status