From a79a7ac0766ce499252f473036fca170f702d2e7 Mon Sep 17 00:00:00 2001 From: venus Date: Sun, 5 Apr 2026 22:59:09 -0500 Subject: [PATCH] initialized as project --- README.md | 29 +++++++++++++++++++++++++++++ config.toml | 8 ++++++++ pyproject.toml | 2 +- src/__init.py__ | 2 ++ src/commands.py | 9 +++++++++ main.py => src/main.py | 2 ++ 6 files changed, 51 insertions(+), 1 deletion(-) create mode 100644 config.toml create mode 100644 src/__init.py__ create mode 100644 src/commands.py rename main.py => src/main.py (65%) diff --git a/README.md b/README.md index e69de29..fa91613 100644 --- a/README.md +++ b/README.md @@ -0,0 +1,29 @@ +# CTF toolchain for linux +This project is meant to be an ai-enhancing ctf toolchain to track your work and help you faster +The system keeps track of your file history, current ctf, challenge catagory, etc to make it easy to provide AI with the context to give you the right answer +The focus is on building a solid methodology to solve any problem. + + +# Dev flow +## initialize a competition +Take user input (eventually screenshots) and generate a new competition directory with directories for each catagory +## Initialize a challenge +Make a new challenge directory and cd into it +Review recently downloaded files, and add challenge files +## Progress tracker +Generate an active log file from command history +Accept user prompts to inform history +- finished (challenge finished) +- begin route (start a new path of exploration) +- help (prompts AI with challenge and progress to give reliable and relevant help) +- success (current path succeeded with previously run command) +- context (add context at this point in the log) +## Built in scripts and libraries +- built in rapid forensics testing and flag analysis based on context +## Write up aid +Shows all of your quickly commented notes +Creates prompt for AI to generate a write up showing your process +- feedback (generates feedback on your work flow and suggests improvements) + +# Misc +the end goal is to create a methodology solid enough to build out a full AI tool chain around it while allowing tight human integration diff --git a/config.toml b/config.toml new file mode 100644 index 0000000..c759ace --- /dev/null +++ b/config.toml @@ -0,0 +1,8 @@ +#config +#file with global options +#key = "val" +[CTF-DATA] +current-challenge = "testChal" +current-comp = "testComp" +key-format = "SKY-aaaa-0000" +#comments ignored diff --git a/pyproject.toml b/pyproject.toml index 7ea5331..e54ce7f 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -1,7 +1,7 @@ [project] name = "ctf" version = "0.1.0" -description = "Add your description here" +description = "An AI enhanced CTF toolchain" readme = "README.md" requires-python = ">=3.14" dependencies = [] diff --git a/src/__init.py__ b/src/__init.py__ new file mode 100644 index 0000000..26cb1c0 --- /dev/null +++ b/src/__init.py__ @@ -0,0 +1,2 @@ +# Initialize the projcet (make a package) +# src/__init.py__ diff --git a/src/commands.py b/src/commands.py new file mode 100644 index 0000000..43095f2 --- /dev/null +++ b/src/commands.py @@ -0,0 +1,9 @@ +# functions for commands needed +# src/commands.py +import os + +# Read variables + +# Initialize a challenge +## Copy files into directory +## add section to log diff --git a/main.py b/src/main.py similarity index 65% rename from main.py rename to src/main.py index 58ddcb7..f0b6426 100644 --- a/main.py +++ b/src/main.py @@ -1,3 +1,5 @@ +# src/main.py +# Parses and calls commands def main(): print("Hello from ctf!")