jctx 1.8.0

Extracts Java/Kotlin code structure for AI context.

Jctx — Give AI full understanding of your Java & Kotlin codebase

Stop pasting files. Get real architecture-aware answers.

Generate complete project context in seconds.

Turn any Java or Kotlin project into a single AI-ready context.txt (or context.md) in seconds.

Jctx "C:\projects\MyApp"
→  context.txt written  (Java: 39 files | Kotlin: 12 files | POM: 1 file | Gradle: 1 file)

No config. No dependencies. Just Python and a folder.

---

Why it exists

You're working on a Java or Kotlin project. You open an AI chat to get help. Before you can even ask your question, you spend 10 minutes copy-pasting files, explaining your class structure, summarising what each module does.

Before: ChatGPT suggests random classes

After: ChatGPT tells exactly which class to modify and why

Jctx does all of that in one command.

It scans your project and writes a clean, structured context.txt (or context.md) — every class, every field, every method signature, every Javadoc/KDoc comment, and your build files — formatted so an AI can immediately understand your entire codebase.

It also provides Token Count Estimation, Language Percentages, and a Dependency Graph — all printed to your console automatically.

Paste it. Ask your question. Get useful answers.

---

Output (real example)

Click to expand sample context.md (Markdown Mode)

# JCTX v1.8.0 — Context Report

- **Project:** `C:\projects\Talken`
- **Date:** 2026-03-31 12:00:00
- **Files:** **Java:** 39 file(s) · **Kotlin:** 5 file(s) · **POM:** 1 file(s) · **Gradle:** 1 file(s)

---

## 1. Project File Tree

```
Talken\
├── src\
│   └── main\
│       ├── java\
│       │   └── org\
│       │       └── flexstudios\
│       │           └── talken\
│       │               ├── Controls.java
│       │               └── TalkenClient.java
│       └── kotlin\
│           └── org\
│               └── flexstudios\
│                   └── talken\
│                       └── UserProfile.kt
├── build.gradle
└── pom.xml
```

## 2. POM.XML Content

#### `pom.xml`
```xml
<?xml version="1.0" encoding="UTF-8"?>
<project>
    <modelVersion>4.0.0</modelVersion>
    <groupId>org.flexstudios</groupId>
    <artifactId>talken</artifactId>
    <version>1.0.0</version>
</project>
```

## 3. Kotlin Class & Member Details

#### 📄 `src\main\kotlin\org\flexstudios\talken\UserProfile.kt`

### Class: `UserProfile`
> Represents the user's local profile settings.

**Data Members:**

| Access | Modifiers | Type | Name | Comment |
|--------|-----------|------|------|---------|
| private | val | `String` | `displayName` | |
| private | val | `String` | `email` | |

**Methods:**

1. `String getAboutSection()`
   - *(no documentation)*

---

Install (Windows)

1. Download The Latest Release Zip.
2. Unzip it
3. Right-click Setup.bat → Run as administrator
4. Open a new terminal

Jctx "C:\path\to\your\java\project"

That's it. context.txt appears inside your project folder.

No admin rights? Copy Jctx.py + Jctx.bat anywhere and run Jctx.bat directly.

Not on Windows? Run python Jctx.py "path/to/project" on any OS with Python 3.8+.

---

Usage

Jctx <project_folder> [--md] [--slim] [--no-tree] [--clipboard] [--print] [--version] [--help]

Flag	Effect
(none)	Saves context.txt into your project folder and prints token estimates
--md	Outputs a cleanly formatted Markdown file (context.md) instead of plain text
--slim	Slim mode: output only class names and method signatures (omits fields and docs) to save tokens
--no-tree	Skips the file tree section (shorter output)
--clipboard	Copies the generated report directly to your clipboard
--print	Also prints to the console
--version	Shows the Jctx version
--help	Shows help

---

How to use the output

Paste context.txt (or the contents of context.md) into any AI chat and ask your question:

"Here's my Java/Kotlin project structure: [paste]. I want to refactor the messaging module to use WebSockets — where should I start?"

Works great with Claude, ChatGPT, Gemini, and any other AI that accepts long text input.

---

Console Metrics

After generating the file, Jctx prints a full analytics dashboard to your console:

Language Percentages

Shows the exact split of Java vs Kotlin code with a visual progress bar:

================================================================
 LANGUAGE PERCENTAGES
================================================================
  Java    :  68.2%  ██████████████████████████████████░░░░░░░░░░░░░░░░  (~23,400 tokens)
  Kotlin  :  31.8%  ███████████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░  (~10,910 tokens)
================================================================

Dependency Graph

Automatically maps which of your project classes depend on which (only project-internal references — no external library noise):

================================================================
 DEPENDENCY GRAPH (project-internal)
================================================================
  EncryptionModule → (none)
  MessagingModule → EncryptionModule, UserProfile
  TalkenClient → EncryptionModule, MessagingModule, UserProfile
  UserProfile → (none)
================================================================

Token Count Estimate

Shows the total token count with a breakdown by section and checks whether your context fits each major AI model's context window:

================================================================
 TOKEN ESTIMATE
================================================================
  Total tokens : ~34,767

  Language Breakdown:
    Java        : ~  23,400  ( 67.3%)
    Kotlin      : ~  10,910  ( 31.4%)
    Build files : ~     145  (  0.4%)
    File tree   : ~     312  (  0.9%)

  Context Window Fit:
    Y Llama 4 Scout (10M)      Y Gemini 3.1 (2M)          Y Grok (2M)
    Y GPT-5.4 (1M)             Y Claude 4.6 (1M)          Y Qwen 3 (1M)
================================================================

---

.jctxignore — Custom Exclusions

Place a .jctxignore file in the project root to exclude additional directories or files from context extraction:

# Skip test directories
**/test/**

# Skip generated code
generated/

# Skip specific file patterns
*.test.java

Pattern	Meaning
dirname/	Skip any directory named dirname
**/test/**	Skip any directory named test anywhere in the tree
*.test.java	Skip files matching the glob pattern
# comment	Lines starting with # are ignored

When a .jctxignore is detected, the console banner shows:

  .jctxignore: yes (2 dirs, 1 patterns)

---

What it extracts

What	Detail
File tree	Full project structure, build folders excluded
Build Files	Full content of your pom.xml, build.gradle, and build.gradle.kts
Classes	Java classes/interfaces/enums and Kotlin classes/data classes/objects/interfaces + Javadoc/KDoc
Fields	Type, name, access modifier, val/var (Kotlin), inline comments
Methods	Numbered list — return type, name, params, Javadoc/KDoc and top-level Kotlin functions

Auto-ignored: build/, target/, .idea/, .git/, node_modules/, .gradle/, .class, .jar, and all other build artifacts. Customize further with .jctxignore.

---

Requirements

• Python 3.8 or newer — python.org
• Works on Windows, macOS, Linux

---

Roadmap

• Kotlin support
• Markdown output mode (context.md)
• Multi-language project estimations (mixed Java + Kotlin percentages)
• Token count estimate alongside output
• Clipboard support and Slim mode
• Dependency graph (project-internal)
• .jctxignore custom exclusions
• Cross-platform packaging (Homebrew / pip)
• Python language support
• Architecture diagram generation (--diagram)

---

License

MIT — free to use, modify, and share.