@phanthy/phanthy-code 0.1.0

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.
package/README.md ADDED
@@ -0,0 +1,74 @@
1
+ # phanthy code
2
+
3
+ phanthy code is a software engineering CLI owned and maintained by **phanthy group**.
4
+
5
+ ---
6
+
7
+ ## Ownership
8
+
9
+ - Copyright and ownership belong to phanthy group.
10
+ - phanthy code is maintained as an independent phanthy group project.
11
+ - The default API endpoint is `http://oneapi.4pd.io:3000`; set `PHANTHY_BASE_URL` to override it.
12
+
13
+ ---
14
+
15
+ ## Repository Scope
16
+
17
+ phanthy code is a CLI for performing software engineering tasks such as editing files, running commands, searching codebases, and coordinating workflows.
18
+
19
+ - **Language**: TypeScript
20
+ - **Runtime**: Bun
21
+ - **Terminal UI**: React + [Ink](https://github.com/vadimdemedes/ink)
22
+ - **Scale**: ~1,900 files, 512,000+ lines of code
23
+
24
+ ---
25
+
26
+ ## Directory Structure
27
+
28
+ ```text
29
+ src/
30
+ ├── main.tsx # Entrypoint orchestration (Commander.js-based CLI path)
31
+ ├── commands.ts # Command registry
32
+ ├── tools.ts # Tool registry
33
+ ├── Tool.ts # Tool type definitions
34
+ ├── QueryEngine.ts # LLM query engine
35
+ ├── context.ts # System/user context collection
36
+ ├── cost-tracker.ts # Token cost tracking
37
+
38
+ ├── commands/ # Slash command implementations (~50)
39
+ ├── tools/ # Agent tool implementations (~40)
40
+ ├── components/ # Ink UI components (~140)
41
+ ├── hooks/ # React hooks
42
+ ├── services/ # External service integrations
43
+ ├── screens/ # Full-screen UIs (Doctor, REPL, Resume)
44
+ ├── types/ # TypeScript type definitions
45
+ ├── utils/ # Utility functions
46
+
47
+ ├── bridge/ # IDE and remote-control bridge
48
+ ├── coordinator/ # Multi-agent coordinator
49
+ ├── plugins/ # Plugin system
50
+ ├── skills/ # Skill system
51
+ ├── keybindings/ # Keybinding configuration
52
+ ├── vim/ # Vim mode
53
+ ├── voice/ # Voice input
54
+ ├── remote/ # Remote sessions
55
+ ├── server/ # Server mode
56
+ ├── memdir/ # Persistent memory directory
57
+ ├── tasks/ # Task management
58
+ ├── state/ # State management
59
+ ├── migrations/ # Config migrations
60
+ ├── schemas/ # Config schemas (Zod)
61
+ ├── entrypoints/ # Initialization logic
62
+ ├── ink/ # Ink renderer wrapper
63
+ ├── native-ts/ # Native TypeScript utilities
64
+ ├── outputStyles/ # Output styling
65
+ ├── query/ # Query pipeline
66
+ └── upstreamproxy/ # Proxy configuration
67
+ ```
68
+
69
+ ---
70
+
71
+ ## Research / Ownership Disclaimer
72
+
73
+ - This repository is owned and maintained by **phanthy group**.
74
+ - phanthy code uses the phanthy API configuration by default.
@@ -0,0 +1,5 @@
1
+ #!/usr/bin/env bun
2
+ // phanthy code CLI launcher
3
+ // This script is the `bin` entrypoint installed by npm/bun.
4
+ // It dispatches to the compiled bundle published in the npm package.
5
+ import '../dist/cli.js'