@towles/tool 0.0.53 → 0.0.54

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/README.md +44 -74
  2. package/package.json +5 -4
package/README.md CHANGED
@@ -1,14 +1,6 @@
1
1
  # Towles Tool
2
2
 
3
- Personal CLI toolkit with autonomous task runner and quality-of-life commands for daily development.
4
-
5
- ## Features
6
-
7
- - **Ralph** - Autonomous task runner with session forking and context reuse
8
- - **Observability** - Token usage visualization with interactive treemaps
9
- - **Git workflows** - Branch creation, PR generation, and cleanup
10
- - **Journaling** - Daily notes, meeting notes, and general notes
11
- - **Claude Code plugins** - Personal plugin marketplace for Claude Code integration
3
+ Personal CLI toolkit with autonomous task runner and developer utilities.
12
4
 
13
5
  ## Installation
14
6
 
@@ -26,93 +18,71 @@ claude plugin update tt@towles-tool
26
18
  git clone https://github.com/ChrisTowles/towles-tool.git
27
19
  cd towles-tool
28
20
  pnpm install
29
- pnpm start # Run directly with tsx
21
+ pnpm start
30
22
  ```
31
23
 
32
24
  ## CLI Commands
33
25
 
34
26
  ### Ralph (autonomous runner)
35
27
 
36
- | Command | Description |
37
- | --------------------------- | --------------------------------------------- |
38
- | `tt ralph plan add <desc>` | Add task to plan |
39
- | `tt ralph plan list` | View tasks |
40
- | `tt ralph plan done <id>` | Mark task complete |
41
- | `tt ralph plan remove <id>` | Remove task |
42
- | `tt ralph run` | Run autonomous loop (auto-commits by default) |
43
- | `tt ralph show` | Show plan with mermaid graph |
28
+ | Command | Description |
29
+ | ----------------------------- | ---------------------- |
30
+ | `tt ralph plan add "path.md"` | Add plan from file |
31
+ | `tt ralph plan list` | View plans |
32
+ | `tt ralph plan done <id>` | Mark complete |
33
+ | `tt ralph plan remove <id>` | Remove plan |
34
+ | `tt ralph show` | Show plan with mermaid |
35
+ | `tt ralph run` | Run (auto-commits) |
36
+ | `tt ralph run --planId 5` | Run specific plan |
44
37
 
45
38
  ### Observability
46
39
 
47
- | Command | Description |
48
- | ------------------------- | ------------------------------------- |
49
- | `tt graph` | Generate HTML treemap of all sessions |
50
- | `tt graph --session <id>` | Single session treemap |
51
- | `tt graph --open` | Auto-open in browser |
52
-
53
- Treemap colors indicate input/output token ratio: green <2:1, yellow 2-5:1, red >5:1.
40
+ | Command | Description |
41
+ | ------------------------- | ------------------------ |
42
+ | `tt graph` | Token Usage (auto-opens) |
43
+ | `tt graph --session <id>` | Single session |
44
+ | `tt graph --days 14` | Filter to last N days |
54
45
 
55
46
  ### Git
56
47
 
57
- | Command | Alias | Description |
58
- | -------------------- | ------- | ------------------------------- |
59
- | `tt gh branch` | | Create branch from GitHub issue |
60
- | `tt gh pr` | `tt pr` | Create pull request |
61
- | `tt gh branch-clean` | | Delete merged branches |
48
+ | Command | Description |
49
+ | -------------------- | ------------------------------- |
50
+ | `tt gh branch` | Create branch from GitHub issue |
51
+ | `tt gh pr` | Create pull request |
52
+ | `tt gh branch-clean` | Delete merged branches |
62
53
 
63
54
  ### Journaling
64
55
 
65
- | Command | Alias | Description |
66
- | ------------------------ | ---------- | -------------------------------- |
67
- | `tt journal daily-notes` | `tt today` | Weekly files with daily sections |
68
- | `tt journal meeting` | `tt m` | Meeting notes |
69
- | `tt journal note` | `tt n` | General notes |
56
+ | Command | Alias | Description |
57
+ | ------------------------ | ---------- | ------------- |
58
+ | `tt journal daily-notes` | `tt today` | Weekly/daily |
59
+ | `tt journal meeting` | `tt m` | Meeting notes |
60
+ | `tt journal note` | `tt n` | General notes |
70
61
 
71
62
  ### Utilities
72
63
 
73
- | Command | Alias | Description |
74
- | ------------ | -------- | ------------------------------ |
75
- | `tt config` | `tt cfg` | Show configuration |
76
- | `tt doctor` | | Check dependencies |
77
- | `tt install` | | Configure Claude Code settings |
78
-
79
- ## Claude Code Plugin Skills
80
-
81
- Available via `/tt:<command>`:
82
-
83
- | Command | Description |
84
- | ------------- | --------------------------------------------- |
85
- | `/tt:commit` | AI-powered conventional commit messages |
86
- | `/tt:plan` | Interview user and create implementation plan |
87
- | `/tt:improve` | Explore codebase and suggest improvements |
88
- | `/tt:refine` | Fix grammar/spelling in files |
89
-
90
- ## Development
64
+ | Command | Description |
65
+ | ------------ | ------------------------------ |
66
+ | `tt config` | Show configuration |
67
+ | `tt doctor` | Check dependencies |
68
+ | `tt install` | Configure Claude Code settings |
91
69
 
92
- ```bash
93
- pnpm start # Run CLI with tsx
94
- pnpm test # Run tests
95
- pnpm lint # Run oxlint
96
- pnpm format # Format with oxfmt
97
- pnpm typecheck # Type check
98
- ```
99
-
100
- ### Releasing
101
-
102
- ```bash
103
- gh workflow run release.yml -f bump_type=patch # or minor/major
104
- gh run watch
105
- ```
70
+ ## Claude Code Skills
106
71
 
107
- ## Resources
72
+ | Skill | Description |
73
+ | ------------------------ | ----------------------------- |
74
+ | `/tt:plan` | Create implementation plan |
75
+ | `/tt:improve` | Suggest codebase improvements |
76
+ | `/tt:refactor-claude-md` | Fix grammar/spelling |
77
+ | `/tt:refine` | Fix grammar/spelling |
108
78
 
109
- ### Claude Code Plugin Development
79
+ ## Guidelines
110
80
 
111
- - [Claude Code Plugins Announcement](https://www.anthropic.com/news/claude-code-plugins)
112
- - [Official Claude Code Plugins](https://github.com/anthropics/claude-code/tree/main/plugins)
113
- - [Skills Guide](https://docs.claude.com/en/api/skills-guide)
114
- - [Best Practices](https://docs.claude.com/en/docs/agents-and-tools/agent-skills/best-practices)
81
+ - [Architecture](docs/architecture.md) - CLI structure, plugin system, tech stack
82
+ - [Claude Code Planning and Running Usage](docs/ralph-tools-for-claude-code.md) - "Claude Code" autonomous runner
83
+ - [CICD via GitHub Actions](docs/github-actions.md) - Automated release workflow
84
+ - [Testing](docs/testings.md) - Info about Tests
115
85
 
116
86
  ## License
117
87
 
118
- [MIT](./LICENSE) License © [Chris Towles](https://github.com/ChrisTowles)
88
+ [MIT](./LICENSE) © [Chris Towles](https://github.com/ChrisTowles)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@towles/tool",
3
- "version": "0.0.53",
3
+ "version": "0.0.54",
4
4
  "description": "CLI tool with autonomous task runner (ralph), observability, and quality-of-life commands for daily development.",
5
5
  "keywords": [
6
6
  "autonomic",
@@ -79,15 +79,16 @@
79
79
  "vitest": "^3.1.3"
80
80
  },
81
81
  "simple-git-hooks": {
82
- "pre-commit": "pnpm lint-staged && pnpm typecheck"
82
+ "pre-commit": "pnpm lint-staged && pnpm format && pnpm typecheck"
83
83
  },
84
84
  "lint-staged": {
85
85
  "package.json": "oxfmt --write",
86
86
  "*.{ts,tsx,mts,cts,js,cjs,mjs}": [
87
- "oxfmt --write",
88
87
  "oxlint --fix"
89
88
  ],
90
- "*.{json,md,yaml,yml}": "oxfmt --write"
89
+ "*.*": [
90
+ "oxfmt --write"
91
+ ]
91
92
  },
92
93
  "oclif": {
93
94
  "bin": "tt",