How kalkiii1511/kites works
Kites is a RISC-V assembly editor and simulator, with a headless CLI. The main workflow is to edit or load assembly, assemble it into a program, load that program into a selected processor, then run or debug it while viewing machine state and profiling results. The repository also provides live language diagnostics, custom pseudo-instructions, cache configuration and Lua-backed custom replacement policies. Edges are limited to relationships shown in the README or source index and excerpts; UI internals and several processor/memory interactions are not sampled.
Main entry points: processor_manager.cpp Processor manager · assembler.cpp Assembler · main.cpp CLI · memory_controller.cpp Memory controller
Components 26
User entry points
- Desktop UI
main.cpp - Assembly editor
src/ui/editor_tab - CLI
cli/main.cpp - Command REPL
cli/repl.cpp - Command handler
src/command_handler/command_handler.cpp
Assembly tools
- Assembler
src/assembler/assembler.cpp - Lexer
src/assembler/lexer.cpp - Parser
src/assembler/parser.cpp - Custom pseudos
src/custom_pseudo_manager/custom_pseudo_manager.cpp - Language service
src/language_service/language_service.cpp - Assembled program
src/common/assembled_program.h
Simulation runtime
- Processor manager
src/processor/processor_manager.cpp - Processor factory
src/processor/processor_factory.cpp - RISC-V processors
src/processor/rvss/rvss_processor.cpp - Memory controller
src/processor/memory_controller.cpp - Cache
src/processor/cache/cache.cpp
Runtime views
- Profiler
src/profiler/profiler.cpp - Processor view
src/ui/processor_tab/processortab.cpp - Memory view
src/ui/memory_tab/memorytab.cpp - Cache view
src/ui/cache_tab/cachetab.cpp - Profiler view
src/ui/profiler_tab/profilertab.cpp
Configuration and extensions
- App configuration
src/config/config.cpp - Custom cache policy
src/processor/cache/custom_policy_engine.cpp - Lua runtime
external/lua-5.5.0/src - Theme manager
src/ui/theme/theme_manager.cpp
Other components
- Engineer
Connections 26
- Engineer → Desktop UI: opens
- Engineer → CLI: runs
- Desktop UI → Assembly editor: presents
- CLI → Assembler: assembles
cli/main.cpp - CLI → Processor manager: runs through
cli/main.cpp - CLI → Command REPL: enters
cli/main.cpp - Command REPL → Command handler: dispatches
- Command handler → Assembler: loads via
src/command_handler/command_handler.cpp - Command handler → Processor manager: controls
- Assembler → Lexer: uses
- Assembler → Parser: uses
- Parser → Assembled program: produces
src/common/assembled_program.h - Language service → Assembler: checks source with
src/language_service/language_service.cpp - Language service → Custom pseudos: uses
src/language_service/language_service.cpp - Processor manager → Assembled program: loads
src/processor/processor_manager.cpp - Processor manager → Processor factory: creates via
src/processor/processor_manager.cpp - Processor manager → RISC-V processors: selects
src/processor/processor_manager.cpp - Processor manager → Profiler: forwards clock events
src/processor/processor_manager.cpp - Memory controller → Cache: uses
- Memory controller → App configuration: reads configuration
- Custom cache policy → Lua runtime: calls
src/processor/cache/custom_policy_engine.cpp - Profiler → Profiler view: shown in
- Processor manager → Processor view: updates
- Memory controller → Memory view: displayed by
- Cache → Cache view: displayed by
- Engineer → Theme manager: customizes appearance