epiq 0.2.0 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/package.json +1 -1
  2. package/readme.md +43 -35
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "epiq",
3
- "version": "0.2.0",
3
+ "version": "0.2.1",
4
4
  "license": "MIT",
5
5
  "type": "module",
6
6
  "description": "EPIQ - CLI based issue tracker",
package/readme.md CHANGED
@@ -1,30 +1,38 @@
1
- # epiq
1
+ # Epiq
2
2
 
3
- > **The ultimate productivity tool** — a CLI-based issue tracking client powered by Git as its backend, living directly inside the repository you work in.
4
- > No external services. No context switching. Just tickets - versioned and colocated with your code.
3
+ **CLI-native issue tracker** powered by Git.
5
4
 
6
- ---
5
+ ```
6
+ '███████╗██████╗ ██╗ ██████╗ '
7
+ '██╔════╝██╔══██╗██║██╔═══██╗'
8
+ '█████╗ ██████╔╝██║██║ ██║'
9
+ '██╔══╝ ██╔═══╝ ██║██║▄▄ ██║'
10
+ '███████╗██║ ██║╚██████╔╝'
11
+ '╚══════╝╚═╝ ╚═╝ ╚═══▀▀╝ '
12
+ 🫡 Never leave your editor!
13
+ ```
7
14
 
8
15
  ## Why epiq?
9
16
 
10
- - **Simplicity** Skip the additional tooling complexity
11
- - **Repo-native** — Lives inside your project directory
12
- - **Offline-ready** — Works wherever Git works
13
- - **Team-friendly** — Collaborate through normal Git workflows
14
- - **Shareable** — ASCII board exported to `.md`, viewable in the CLI, on GitHub/GitLab, or as your project README.
15
- - **CLI-first** — Fast, scriptable, and developer/agent-friendly
17
+ Never leave your favorite editor!
18
+
19
+ - **Zero setup** — no dashboards, no setup overhead
20
+ - **Repo-native** — your issues live where your code lives
21
+ - **Offline-first** — works anywhere Git works
22
+ - **Portable** — your entire project state travels with the repo
23
+ - **CLI-first** — fast, scriptable, and automation-friendly
16
24
 
17
25
  ---
18
26
 
19
- ## 📦 Installation
27
+ ## Installation
20
28
 
21
- Install globally using npm:
29
+ Install globally via npm:
22
30
 
23
31
  ```bash
24
32
  npm install --global epiq
25
33
  ```
26
34
 
27
- Verify installation:
35
+ Verify:
28
36
 
29
37
  ```bash
30
38
  epiq --version
@@ -32,43 +40,43 @@ epiq --version
32
40
 
33
41
  ---
34
42
 
35
- ## 🚀 Getting Started
43
+ ## Getting Started
36
44
 
37
- ### Initialize a project
45
+ Starting the application will launch a wizard that sets you up in 20 seconds.
46
+ It will result in settings persisted at `~/.epicrc`
38
47
 
39
- Create a new epiq workspace inside your current directory:
48
+ In any folder, run:
40
49
 
41
50
  ```bash
42
- epiq --init "Project Name"
51
+ epiq
43
52
  ```
44
53
 
45
- This sets up epiq in your repository and prepares it for issue tracking.
54
+ This opens the interactive CLI workspace.
46
55
 
47
56
  ---
48
57
 
49
- ### Open the workspace
58
+ ## Philosophy
50
59
 
51
- Run epiq inside any initialized repository:
60
+ What epiq brings:
52
61
 
53
- ```bash
54
- epiq
55
- ```
56
-
57
- This opens the interactive CLI workspace.
62
+ - **Speed** — event sourcing to the file system keeps operations fast
63
+ - **Editor-level productivity** — stay in the environment you already use
64
+ - **Repo-native issues** — tickets live alongside your code
65
+ - **Built-in versioning** — Git is the backend
66
+ - **Seamless collaboration** leverage Git’s distributed workflow
67
+ - **Fully distributed** — no central configuration or registration required
58
68
 
59
69
  ---
60
70
 
61
- ## 🛠 Philosophy
62
-
63
- epiq keeps issue tracking:
64
-
65
- - Close to your code
66
- - Versioned with your commits
67
- - Simple and transparent
68
- - Independent from external platforms
71
+ ## Features
69
72
 
70
- If you use Git, you already have everything you need.
73
+ - Issue tracking — lightweight, structured tickets
74
+ - Event log — full history of every change
75
+ - Filtering — query issues by tags, assignees, and more
76
+ - Navigation-first UI — fast keyboard-driven workflow
77
+ - Markdown descriptions — shareable, human-readable boards
78
+ - Extensible command system — built with automation in mind
71
79
 
72
80
  ---
73
81
 
74
- Built for developers who live in the terminal.
82
+ ## What it looks like