do-next 0.0.0-2026.4.8

Pick your next Jira task & manage it from the terminal
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136

# do-next

> [!IMPORTANT]
> Experimental & unstable! I'm exploring the problem space. Everything might change.

Pick your next Jira task & manage it from the terminal.

<!-- TODO: add a screenshot or demo GIF -->

## Pre-release state

Right now `do-next` is intended for internal use in my teams.

`v0.0.0-yyyy.mm.dd` is the versioning scheme before the release.

Polished experience and documentation are coming closer to the first public release.

---

## Installation

The main way before the release is to [build from source](#development).

Following solutions are supported at the best effort:

### Binaries

Download a compiled binary from [GitHub Releases](https://github.com/ejiektpobehuk/do-next/releases)

### Rust way

Pre-release versions have to be provided explicitly:

```sh
cargo install do-next@0.0.0-yyyy.mm.dd
```

The latest published version: ![Crates.io Version](https://img.shields.io/crates/v/do-next?style=flat-square&label=%40&labelColor=282828&color=3c3836)

### Nix way

This repo provides a flake.
I guess, you know how to configure in on your own ^.~

```sh
nix run github:ejiektpobehuk/do-next
```

## Runtime dependencies

macOS and Windows have no extra dependencies.

Linux depends on:
- `xdg-utils` to open Issues in a browser
- `dbus` & secret service provider for optional keyring secret management

---

## Quick start

`do-next` has a built-in onboarding.

`do-next auth` to reconfigure authentication only.

---

## Development

Dependencies:

- `just` — *optional* command runner
- `cargo` — the Rust package manager
- msrv — `1.88.0`
- `dbus` — Linux specific dependency

`just` acts as a `cargo` wrapper that overwrites some defaults and provides a wrapper for NixOS dev shell.

Run `just` to list all available commands:

```
just
Available recipes:
    build
    check
    default
    lint
    lint-fix
    run
    shell
    test
```

### NixOS

libdbus is a runtime and a build dependency.
You'll need the dev shell to handle it properly.
`just` handles calling the dev shell if it detects that it's running in a NixOS environment.

### Non-NixOS Linux

The `sync-secret-service` keyring backend requires the dbus development headers:

**Arch Linux**
```sh
sudo pacman -S dbus pkgconf
```

**Debian/Ubuntu**
```sh
sudo apt install libdbus-1-dev pkg-config
```

**Fedora**
```sh
sudo dnf install dbus-devel pkgconf-pkg-config
```

### macOS / Windows

```sh
just build
```

or

```sh
cargo build
```

No extra system dependencies required.

---

## License

Licensed under either of [MIT](LICENSE-MIT) or [Apache-2.0](LICENSE-APACHE) at your option.