A VS Code extension that streamlines your daily work routine by providing one-click check-in and check-out functionality for both Zoho People and Basecamp.
Features
One-click check-in/out: Perform both Zoho People attendance tracking and Basecamp status updates with a single command
Status bar integration: Convenient buttons in the VS Code status bar for quick access
Customizable messages: Configure your check-in and check-out messages for Basecamp
Requirements
Zoho People account with API access
Basecamp account with API access
Valid API credentials for both services
Extension Settings
This extension contributes the following settings:
zoho-basecamp.zohoToken: OAuth token for Zoho People
zoho-basecamp.zohoEmail: Your email address for Zoho People
zoho-basecamp.basecampToken: Access token for Basecamp
zoho-basecamp.basecampAccountId: Basecamp account ID
zoho-basecamp.basecampProjectId: Basecamp project ID
zoho-basecamp.basecampMessageBoardId: Basecamp message board ID
zoho-basecamp.checkInMessage: Message to post when checking in (default: "I've started working for the day.")
zoho-basecamp.checkOutMessage: Message to post when checking out (default: "I'm done for the day.")
Setup Instructions
Install the extension from the VS Code Marketplace
Obtain API credentials:
Zoho People
Log in to your Zoho People account
Navigate to Setup → Developer Space → API
Generate an OAuth token for authentication
Add the OAuth token to the extension settings
Note: Zoho has a threshold limit of 100 requests with a lock period of 5 minutes
Zoho API Details
API Endpoint: https://people.zoho.com/people/api/attendance
Authentication: OAuth token in header Authorization: Zoho-oauthtoken <your-token>
Parameters:
dateFormat: Format for date/time
checkIn: Check-in time (format: dd/MM/yyyy HH:mm:ss)
checkOut: Check-out time (format: dd/MM/yyyy HH:mm:ss)
empId or emailId or mapId: At least one identifier is required
Basecamp
Log in to your Basecamp account
Go to your Basecamp profile → "My stuff" → "Apps"
Click "New access token"
Generate a token with appropriate permissions
Add the token to the extension settings
How to Use
Initial Setup
After installing the extension, open VS Code settings (File > Preferences > Settings)
Search for "Dual Check" or "zoho-basecamp"
Fill in all required API credentials and configuration options
Save your settings
Daily Usage
Morning Check-in:
When you start your workday, click the "Check In" button in the VS Code status bar (bottom left)
Alternatively, press Ctrl+Shift+P (or Cmd+Shift+P on Mac) to open the Command Palette
Type "Check In" and select "Check In (Zoho & Basecamp)"
You'll see a notification confirming successful check-in to both systems
Evening Check-out:
When ending your workday, click the "Check Out" button in the status bar
Or use the Command Palette and select "Check Out (Zoho & Basecamp)"
A confirmation notification will appear after successful check-out
Customizing Messages:
To change your check-in/out messages, update the corresponding settings in VS Code preferences
Changes will take effect immediately for your next check-in/out
Troubleshooting
If you see an error notification, check your API credentials in settings
Ensure you have proper internet connectivity
Verify that your Zoho People and Basecamp accounts have the necessary permissions
For Zoho API issues, remember there's a threshold limit of 100 requests with a 5-minute lock period
Architecture
This extension is built using a layered architecture:
Models: Data structures for configuration
Services: Business logic for API interactions
Controllers: Coordination between services
UI: Status bar integration
Utils: Helper functions for date formatting
Known Issues
The extension requires proper API credentials to function correctly
API rate limits may apply based on your Zoho People and Basecamp plans
Release Notes
0.1.0
Initial release with basic check-in/out functionality for Zoho People and Basecamp.
Privacy
This extension does not collect any data. All API credentials are stored locally in your VS Code settings.
