This repository was archived by the owner on Oct 10, 2026. It is now read-only.
Repository navigation
Enhance Gemini CLI server management and documentation #54
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1 +1 @@ | ||
| AGENTS.md |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,65 +1,36 @@ | ||
| # Contributing to T3 Code (Gemini Fork) | ||
|
|
||
| First off, thank you for considering contributing to this fork! It's people like you that make the open-source community such an amazing place to learn, inspire, and create. | ||
|
|
||
| This fork is maintained by [mtdewwolf](https://github.com/mtdewwolf) and focuses on enhancing Gemini CLI support and improving the core orchestration and persistence layers. | ||
|
|
||
| ## How Can I Contribute? | ||
|
|
||
| ### Reporting Bugs | ||
| Before creating bug reports, please check the existing issues to see if the problem has already been reported. When you are creating a bug report, please include as many details as possible. | ||
|
|
||
| ### Suggesting Enhancements | ||
| Enhancement suggestions are tracked as GitHub issues. When creating an enhancement suggestion, please: | ||
| * Use a clear and descriptive title. | ||
| * Provide a step-by-step description of the suggested enhancement. | ||
| * Explain why this enhancement would be useful. | ||
|
|
||
| ### Pull Requests | ||
| We welcome pull requests! To help us review your PR effectively, please: | ||
| 1. **Keep it focused:** Try to keep PRs small and focused on a single change. | ||
| 2. **Test your changes:** Ensure that your changes don't break existing functionality. Add new tests if possible. | ||
| 3. **Document your changes:** Update documentation (like the README) if your changes introduce new features or change existing ones. | ||
| 4. **Describe your PR:** Use the pull request template to describe what changed and why. | ||
|
|
||
| ## Development Setup | ||
|
|
||
| 1. Clone the repository: `git clone https://github.com/mtdewwolf/t3code-gemini.git` | ||
| 2. Install dependencies: `bun install` | ||
| 3. Run the development server: `bun run dev` | ||
|
|
||
| ## Code Style | ||
| Please try to match the existing code style. We use `oxlint` for linting and `oxfmt` for formatting. | ||
|
|
||
| --- | ||
|
|
||
| Special thanks to the original creators at [Pingdotgg](https://github.com/pingdotgg) and the maintainers of the [aaditagrawal fork](https://github.com/aaditagrawal/t3code) for the solid foundation. | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,119 @@ | ||
| import { accessSync, constants, statSync } from "node:fs"; | ||
| import { extname, join } from "node:path"; | ||
|
|
||
| interface CommandPathOptions { | ||
| readonly platform?: NodeJS.Platform; | ||
| readonly env?: NodeJS.ProcessEnv; | ||
| } | ||
|
|
||
| function stripWrappingQuotes(value: string): string { | ||
| return value.replace(/^"+|"+$/g, ""); | ||
| } | ||
|
|
||
| function resolvePathEnvironmentVariable(env: NodeJS.ProcessEnv): string { | ||
| return env.PATH ?? env.Path ?? env.path ?? ""; | ||
| } | ||
|
|
||
| function resolveWindowsPathExtensions(env: NodeJS.ProcessEnv): ReadonlyArray<string> { | ||
| const rawValue = env.PATHEXT; | ||
| const fallback = [".COM", ".EXE", ".BAT", ".CMD"]; | ||
| if (!rawValue) return fallback; | ||
|
|
||
| const parsed = rawValue | ||
| .split(";") | ||
| .map((entry) => entry.trim()) | ||
| .filter((entry) => entry.length > 0) | ||
| .map((entry) => (entry.startsWith(".") ? entry.toUpperCase() : `.${entry.toUpperCase()}`)); | ||
| return parsed.length > 0 ? Array.from(new Set(parsed)) : fallback; | ||
| } | ||
|
|
||
| function resolvePathDelimiter(platform: NodeJS.Platform): string { | ||
| return platform === "win32" ? ";" : ":"; | ||
| } | ||
|
|
||
| function resolveCommandCandidates( | ||
| command: string, | ||
| platform: NodeJS.Platform, | ||
| windowsPathExtensions: ReadonlyArray<string>, | ||
| ): ReadonlyArray<string> { | ||
| if (platform !== "win32") return [command]; | ||
| const extension = extname(command); | ||
| const normalizedExtension = extension.toUpperCase(); | ||
|
|
||
| if (extension.length > 0 && windowsPathExtensions.includes(normalizedExtension)) { | ||
| const commandWithoutExtension = command.slice(0, -extension.length); | ||
| return Array.from( | ||
| new Set([ | ||
| command, | ||
| `${commandWithoutExtension}${normalizedExtension}`, | ||
| `${commandWithoutExtension}${normalizedExtension.toLowerCase()}`, | ||
| ]), | ||
| ); | ||
| } | ||
|
|
||
| const candidates: string[] = []; | ||
| for (const windowsPathExtension of windowsPathExtensions) { | ||
| candidates.push(`${command}${windowsPathExtension}`); | ||
| candidates.push(`${command}${windowsPathExtension.toLowerCase()}`); | ||
| } | ||
| return Array.from(new Set(candidates)); | ||
| } | ||
|
|
||
| function isExecutableFile( | ||
| filePath: string, | ||
| platform: NodeJS.Platform, | ||
| windowsPathExtensions: ReadonlyArray<string>, | ||
| ): boolean { | ||
| try { | ||
| const stat = statSync(filePath); | ||
| if (!stat.isFile()) return false; | ||
| if (platform === "win32") { | ||
| const extension = extname(filePath); | ||
| if (extension.length === 0) return false; | ||
| return windowsPathExtensions.includes(extension.toUpperCase()); | ||
| } | ||
| accessSync(filePath, constants.X_OK); | ||
| return true; | ||
| } catch { | ||
| return false; | ||
| } | ||
| } | ||
|
|
||
| export function resolveCommandPath( | ||
| command: string, | ||
| options: CommandPathOptions = {}, | ||
| ): string | undefined { | ||
| const platform = options.platform ?? process.platform; | ||
| const env = options.env ?? process.env; | ||
| const windowsPathExtensions = platform === "win32" ? resolveWindowsPathExtensions(env) : []; | ||
| const commandCandidates = resolveCommandCandidates(command, platform, windowsPathExtensions); | ||
|
|
||
| if (command.includes("/") || command.includes("\\")) { | ||
| return commandCandidates.find((candidate) => | ||
| isExecutableFile(candidate, platform, windowsPathExtensions), | ||
| ); | ||
| } | ||
|
|
||
| const pathValue = resolvePathEnvironmentVariable(env); | ||
| if (pathValue.length === 0) return undefined; | ||
|
|
||
| const pathEntries = pathValue | ||
| .split(resolvePathDelimiter(platform)) | ||
| .map((entry) => stripWrappingQuotes(entry.trim())) | ||
| .filter((entry) => entry.length > 0); | ||
|
|
||
| for (const pathEntry of pathEntries) { | ||
| for (const candidate of commandCandidates) { | ||
| const resolvedPath = join(pathEntry, candidate); | ||
| if (isExecutableFile(resolvedPath, platform, windowsPathExtensions)) { | ||
| return resolvedPath; | ||
| } | ||
| } | ||
| } | ||
|
|
||
| return undefined; | ||
| } | ||
|
|
||
| export function isCommandAvailable(command: string, options: CommandPathOptions = {}): boolean { | ||
| return resolveCommandPath(command, options) !== undefined; | ||
| } |
Oops, something went wrong.
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Fix clone target to the active fork repository.
The setup command currently clones
mtdewwolf/t3code-gemini, which can route contributors away from this fork’s contribution flow.Suggested doc fix
Based on learnings: "Always explicitly target the fork with
--repo aaditagrawal/t3codewhen runninggh pr create. Never runghwrite commands against any repo other thanaaditagrawal/t3code."📝 Committable suggestion
🤖 Prompt for AI Agents