https://github.com/alessandroraffa/arit-toolkit
https://github.com/alessandroraffa/arit-toolkit
agentic-coding ai aider claude-code cline copilot developer-tools productivity session-archiving timestamp vscode-extension
Last synced: about 13 hours ago
JSON representation
- Host: GitHub
- URL: https://github.com/alessandroraffa/arit-toolkit
- Owner: alessandroraffa
- License: mit
- Created: 2026-02-05T19:17:45.000Z (13 days ago)
- Default Branch: main
- Last Pushed: 2026-02-15T17:54:32.000Z (3 days ago)
- Last Synced: 2026-02-16T00:40:47.848Z (3 days ago)
- Topics: agentic-coding, ai, aider, claude-code, cline, copilot, developer-tools, productivity, session-archiving, timestamp, vscode-extension
- Language: TypeScript
- Size: 8.05 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# ARIT Toolkit
[](https://github.com/alessandroraffa/arit-toolkit/actions/workflows/ci.yml)
[](https://marketplace.visualstudio.com/items?itemName=alessandroraffa.arit-toolkit)
[](https://marketplace.visualstudio.com/items?itemName=alessandroraffa.arit-toolkit)
[](https://opensource.org/licenses/MIT)
A collection of productivity utilities for Visual Studio Code.
**ARIT** stands for **A**lessandro **R**affa **I**nformation **T**echnologies.
## Features
All timestamps are generated in **UTC timezone**.
### Timestamped File Creator
Create new files with automatic timestamp prefixes. Perfect for:
- Daily notes and journals
- Meeting notes
- Log files
- Version-tracked documents
**Usage:**
- Right-click on a folder in Explorer → "ARIT: New File with Timestamp"
- Keyboard shortcut: `Ctrl+Alt+N` / `Cmd+Alt+N` (when Explorer is focused)
- Command Palette: "ARIT: New File with Timestamp"
**Example:** Creates `202602051430-meeting-notes.md`
### Timestamped Directory Creator
Create new directories with automatic timestamp prefixes. Same logic as the file creator, but for folders.
**Usage:**
- Right-click on a folder in Explorer → "ARIT: New Folder with Timestamp"
- Keyboard shortcut: `Ctrl+Alt+Shift+N` / `Cmd+Alt+Shift+N` (when Explorer is focused)
- Command Palette: "ARIT: New Folder with Timestamp"
**Example:** Creates `202602051430-project-assets/`
### Prefix Creation Timestamp
Add the creation timestamp as a prefix to existing files or directories. Useful for organizing by when they were created.
**Usage:**
- Right-click on a file in Explorer → "ARIT: Prefix Creation Timestamp"
- Right-click on a folder in Explorer → "ARIT: Prefix Creation Timestamp to Folder"
**Example (file):** `report.pdf` → `202602051430-report.pdf` (uses the file's actual creation date)
**Example (folder):** `assets/` → `202602051430-assets/` (uses the folder's actual creation date)
> **Note:** These features are only available via the Explorer context menu.
### Extension Toggle (Status Bar)
Quickly enable or disable advanced ARIT Toolkit features for the current workspace via a status bar icon.
**Status Bar:**
An "ARIT" item appears in the bottom-right status bar. It shows:
- The current enabled/disabled state
- A tooltip with feature list and active configuration on hover
- Click to toggle the extension on/off
**Usage:**
- Click the "ARIT" icon in the status bar
- Command Palette: "ARIT: Toggle Extension (Enable/Disable)"
**Workspace initialization:**
When you open a single-root workspace for the first time, ARIT Toolkit will ask if you want to initialize it for advanced features. Accepting creates a `.arit-toolkit.jsonc` configuration file at the workspace root.
**Workspace modes:**
- **Single-root workspace:** Full functionality with toggle support. State is persisted in `.arit-toolkit.jsonc`.
- **Multi-root workspace:** Basic timestamp commands remain available. The toggle is not available and the status bar indicates limited mode.
When disabled, advanced features show a warning message. Basic timestamp commands always work regardless of the toggle state.
## Installation
### From VS Code Marketplace
1. Open VS Code
2. Press `Ctrl+P` / `Cmd+P`
3. Type `ext install alessandroraffa.arit-toolkit`
### From VSIX File
1. Download the `.vsix` file from [Releases](https://github.com/alessandroraffa/arit-toolkit/releases)
2. In VS Code, press `Ctrl+Shift+P` / `Cmd+Shift+P`
3. Type "Install from VSIX" and select the downloaded file
## Configuration
All timestamp features share the same configuration:
| Setting | Default | Description |
|---------|---------|-------------|
| `arit.timestampFormat` | `YYYYMMDDHHmm` | Format for the timestamp prefix |
| `arit.timestampSeparator` | `-` | Separator between timestamp and filename |
| `arit.logLevel` | `info` | Logging level for debug output |
### Timestamp Formats
| Format | Example Output | Description |
|--------|----------------|-------------|
| `YYYYMMDDHHmm` | `202602051430` | Year, month, day, hour, minute |
| `YYYYMMDD` | `20260205` | Year, month, day only |
| `YYYYMMDDHHmmss` | `20260205143022` | Full timestamp with seconds |
| `ISO` | `2026-02-05T14-30-22-123Z` | ISO 8601 format (with milliseconds) |
## Keyboard Shortcuts
| Command | Windows/Linux | macOS | Context |
|---------------------------|---------------------|--------------------|------------------|
| New File with Timestamp | `Ctrl+Alt+N` | `Cmd+Alt+N` | Explorer focused |
| New Folder with Timestamp | `Ctrl+Alt+Shift+N` | `Cmd+Alt+Shift+N` | Explorer focused |
> **Note:** The "Prefix Creation Timestamp" commands are only available via the Explorer context menu.
## Requirements
- VS Code 1.85.0 or higher
## Contributing
Contributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details.
## Changelog
See [CHANGELOG.md](CHANGELOG.md) for a list of changes.
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## Author
**Alessandro Raffa**
- GitHub: [@alessandroraffa](https://github.com/alessandroraffa)